Как настроить временный API-ключ для Claude Code в 2026 году и не раскрыть долгосрочные учётные данные?

Для Claude Code безопаснее всего получать временный API-ключ через apiKeyHelper или корпоративный шлюз, если поставщик действительно поддерживает нужные права, срок действия и отзыв. Это подходит разработчикам и командам, которые хотят не хранить долгосрочный секрет в проекте; сам короткоживущий токен не ограничивает доступ агента к файлам и сети.
Личный разработчик — если запускает Claude Code на своём Mac и не хочет оставлять секрет в репозитории или сценарии.
Инженер платформы — если настраивает для команды выдачу, обновление и отзыв учётных данных.
Специалист по безопасности — если оценивает, что именно снижает короткий срок действия и какие меры изоляции всё равно нужны.
Сначала разделите учётные данные, а не складывайте их в один секрет
В одной задаче могут участвовать разные удостоверения. Для каждого нужно определить отдельный ресурс, разрешённые действия и ответственного за отзыв.
| Учётные данные | Что открывают | Что подготовить до запуска Claude Code |
|---|---|---|
| Аутентификация модели | API модели или корпоративный шлюз | Выяснить, какой тип токена и заголовок принимает конечная точка |
| Доступ к репозиторию | Чтение, запись или отправку изменений в Git | Отдельно выбрать репозиторий, ветку и допустимые операции |
| Облачная учётная запись | Ресурсы конкретной облачной платформы | Ограничить роль нужным проектом и набором действий |
Один ключ не должен одновременно оплачивать запросы к модели, отправлять код в репозиторий и менять облачную инфраструктуру. Если задача требует доступа только к модели, передача ей облачного токена не добавляет нужной функции, зато расширяет последствия ошибочного использования.
До выдачи запишите: какой ресурс нужен, какие действия допустимы, кто отзовёт доступ и где будет виден факт его применения. Конкретные разрешения, сроки и отзыв проверяйте в документации именно той службы, которая выдаёт учётные данные. Возможности шлюза не означают, что нижележащий API поддерживает такой же уровень ограничений.
Когда временный токен лучше постоянного, а когда нет
Токен, полученный на одну задачу и отзываемый после неё, полезен, когда поставщик способен ограничить его область действия и организация контролирует его жизненный цикл. Для личного проекта с прямым API-доступом можно использовать поддерживаемую Claude Code авторизацию, не обязательно создавать собственную схему коротких токенов. Для корпоративного доступа шлюз может скрыть постоянный ключ провайдера на серверной стороне и выдавать разработчику отдельный секрет для запросов.
В документации Claude Code шлюз описан как промежуточный компонент для централизованного управления учётными данными, учёта использования, бюджетов и аудита. При этом сам шлюз становится частью инфраструктуры, за которую отвечает команда; его совместимость и конфигурацию нужно поддерживать. Описание функций и компромиссов LLM-шлюза.
Решение принимайте по условиям, а не по слову «временный»:
- Если поставщик поддерживает отдельные права, срок и отзыв для конкретного токена — выдавайте задаче такой токен через проверенный механизм.
- Если права ограничиваются, но точный срок или отзыв не поддерживаются — используйте отдельную учётную запись с минимальной ролью и внесите ограничение в план реагирования.
- Если токен нельзя отозвать или разделить по назначению — не передавайте его агенту; выполните операцию вручную либо через сервис-посредник, который не раскрывает исходный секрет.
- Если задача требует изменения локальных файлов или запуска команд — дополните защиту учётных данных отдельными разрешениями и изоляцией среды.
Важно: «короткий» не означает «безопасный при любых условиях». Если процесс успел прочитать секрет или отправить его наружу до истечения срока, окончание срока действия не отменит уже состоявшееся раскрытие.
Перед запуском: проверьте, какие данные и откуда попадут в процесс
Шаг 1. Установите, что именно принимает шлюз
Попросите администратора указать конечный адрес, тип аутентификации и разрешённый способ передачи секрета. В актуальной документации подключения к шлюзу переменная ANTHROPIC_AUTH_TOKEN соответствует токену Bearer, ANTHROPIC_API_KEY — ключу для заголовка x-api-key, а apiKeyHelper предназначен для динамических или получаемых из хранилища учётных данных. Не угадывайте тип: несовпадение переменной и ожидаемого заголовка приводит к отказу аутентификации. Инструкция по подключению Claude Code к LLM-шлюзу.
Шаг 2. Исключите секреты из файлов проекта
Не помещайте ключ в общий .claude/settings.json: файл проекта могут отправлять в систему контроля версий и раздавать команде. Не вставляйте секрет в команду, которую сохраняет история оболочки, и не записывайте его в сценарий запуска. Проверьте, что в рабочей копии, локальных настройках, примерах конфигурации и скриптах нет значения токена.
Для первичной проверки используйте отдельный терминал и временную переменную только для дочернего процесса. Она не превращает секрет в невидимый для локальных средств контроля или других процессов: доступ к окружению, отладочным данным и выводу зависит от системы и способа запуска. Переменную нельзя оставлять в профиле оболочки, если она должна действовать только на одну задачу.
Шаг 3. Выберите хранение для учётных данных пользователя
macOS Keychain — механизм защищённого хранения небольших секретов и управления доступом приложений к элементам связки ключей. Это полезно для обычного входа пользователя, но само по себе не делает любой API-ключ временным и не ограничивает полномочия токена на стороне поставщика. Описание Keychain Services и механизмов контроля доступа объясняет границы этого хранилища.
Текущая документация Claude Code указывает, что на macOS учётные данные хранятся в зашифрованном Keychain; если запись не проходит, например при заблокированной связке ключей в SSH-сеансе, предусмотрен резервный файл ~/.claude/.credentials.json с режимом 0600. Поэтому при удалённом входе проверьте фактический способ хранения, а не исходите из предположения, что Keychain всегда доступен. Раздел об аутентификации и хранении учётных данных.
Шаг 4. Настройте помощник, если токен выдаётся динамически
apiKeyHelper задаётся в настройках Claude Code и вызывает сценарий, возвращающий ключ. В схематичном виде локальная конфигурация выглядит так:
{
"apiKeyHelper": "/полный/путь/к/выдать-токен"
}
Путь и содержимое сценария зависят от вашей системы выдачи. Не храните в нём постоянный секрет, которым скрипт подписывает другие токены. Надёжнее, если сценарий обращается к вашему хранилищу под отдельной служебной идентичностью и возвращает ровно те данные, которые разрешены для этой задачи. Зафиксируйте поведение при недоступности хранилища: лучше остановить запуск, чем незаметно перейти на широкополномочный резервный ключ.
Не предполагайте, что одна запись apiKeyHelper автоматически обеспечивает короткий срок действия. Срок задаёт и применяет источник токена. В Claude Code частоту вызова помощника можно регулировать предусмотренной настройкой CLAUDE_CODE_API_KEY_HELPER_TTL_MS; проверьте актуальную запись в официальном справочнике переменных среды и тестируйте конкретную версию. Кеш помощника может означать, что новый токен не запрашивается при каждом обращении к модели.
Шаг 5. Найдите переменные, которые могут перекрыть помощник
До первого запроса проверьте среду запуска:
printenv | grep -E '^(ANTHROPIC_API_KEY|ANTHROPIC_AUTH_TOKEN|CLAUDE_CODE_API_KEY_HELPER_TTL_MS|ANTHROPIC_BASE_URL)='
Команда выводит значения найденных переменных. Запускайте её только в локальном терминале и не копируйте результат в тикет, чат или журнал сборки. Чтобы проверить лишь наличие секретов, не раскрывая сами значения, можно проверить каждую переменную отдельно:
test -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY задан"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN задан"
В официальной документации указано, что источники аутентификации имеют приоритет: среди них сначала идут учётные данные облачных провайдеров, затем ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY и вывод apiKeyHelper. Значит, настроенный помощник может не использоваться, если в среде остался другой активный секрет. Проверяйте выбранный источник командой /status, а не только содержимое файла настроек. Описание аутентификации и приоритета источников.
Во время задачи: аутентификация не изолирует Mac
API-ключ подтверждает право обращаться к сервису, который его выдал. Он не определяет, сможет ли процесс читать соседние каталоги, запускать оболочку, открывать файлы конфигурации или устанавливать сетевые соединения. Это разные контрольные слои, и их нельзя подменять одним ограниченным токеном.
| Контроль | Что он ограничивает | Чего от него не следует ожидать |
|---|---|---|
| Права и срок токена | Доступ к ресурсам API в пределах политики поставщика | Ограничения на локальные файлы и команды |
| Настройки разрешений Claude Code | Действия инструментов, разрешённые или требующие подтверждения | Полной сетевой изоляции процесса |
| Системная изоляция и сетевые правила | Доступ процесса к среде и сетевым направлениям в рамках выбранного механизма | Автоматического отзыва уже выданного API-токена |
Встроенные разрешения Claude Code, системную песочницу и настройки сети нужно проектировать отдельно. Официальное руководство по безопасности описывает разрешительную модель и её ограничения; актуальные параметры поведения смотрите в руководстве по безопасности и настройках разрешений.
Практический пример: разработчику нужно, чтобы агент прочитал исходники и отправил запросы к модели через рабочий шлюз. Временный токен может уменьшить время, в течение которого украденное значение остаётся пригодным, если шлюз и поставщик действительно поддерживают его отзыв. Но он не остановит процесс от чтения локального файла с другим токеном или от обращения к разрешённому сетью адресу. Для первого риска закрывают ненужные файлы и разделяют среду; для второго — отдельно устанавливают сетевые ограничения.
Проверьте и то, что видит оператор шлюза: аудит запросов помогает расследованию, но сам по себе не доказывает, что секрет не попал в вывод агента, историю терминала или локальный журнал.
Завершение: отзовите доступ и проверьте остатки
С окончанием задачи заканчивается не только работа агента, но и временное разрешение. Закройте сеанс, отзовите выданный токен способом, который предоставляет его поставщик, и проверьте, что отозван именно токен текущей задачи, а не только локальная копия.
| Где проверять | Что искать | Что делать при обнаружении |
|---|---|---|
| Переменные оболочки и профиль | Экспортированные ключи, токены, адреса шлюзов с секретами | Удалить секрет из профиля и открыть чистый сеанс |
| Настройки проекта и пользователя | Значения в settings.json, .env, локальных файлах |
Удалить ключ; проверить историю Git и исключения |
| Командные журналы и вывод | Секреты в командах, ошибках, ответах и диагностике | Ограничить распространение журнала, затем отозвать раскрытый токен |
| Передача задачи другому сотруднику | Скопированный секрет, незавершённые разрешения | Передать идентификатор задачи и процедуру повторной выдачи, не сам ключ |
Если токен попал в коммит, сообщение об ошибке, запись терминала или передачу задачи — считайте его раскрытым и отзовите, даже если предполагалось короткое время действия. Если раскрыт долгосрочный ключ, отзывайте и выпускайте новый. Удаление строки из файла не стирает её из истории версий и копий журнала. После отзыва проверьте результат способом, который предоставляет поставщик, и просмотрите итоговый вывод агента на случайные секреты.
Учтите особенности Claude Code: переменные среды и файлы конфигурации могут иметь разные области действия, а настройки проекта могут быть общими для участников репозитория. В актуальном руководстве предлагается проверять применённые настройки через /status; изменённые файлы настроек обычно перечитываются автоматически, но для конкретной политики и версии проверку следует выполнять самостоятельно. Справочник по областям действия и приоритету настроек.
Для команды заведите карточку каждой выдачи: назначение секрета, субъект выдачи, ресурс и разрешённые действия, срок или условие завершения, ответственный за отзыв, способ аудита и результат проверки после отзыва. Сначала проверьте весь цикл на низкорисковой задаче: запросить токен, подтвердить фактический источник через /status, убедиться в требуемом доступе, завершить задачу, отозвать токен и проверить отказ повторного запроса. Только после этого распространяйте процедуру на общие рабочие среды.
Часто задаваемые вопросы
Как запускать Claude Code без ключа в репозитории?
Не записывайте секрет в общий .claude/settings.json, исходный код, сценарий запуска или историю команд. Для разовой проверки используйте переменные только в текущем процессе терминала; для регулярных задач предпочтительнее apiKeyHelper, который получает токен из вашей системы выдачи. Убедитесь через /status, какой источник выбран.
Что делает apiKeyHelper и как он обновляет токен?
apiKeyHelper запускает настроенный сценарий, который возвращает учётные данные. Он подходит для динамической выдачи из хранилища, но не создаёт срок действия, отзыв или ограничения прав. Частоту повторного вызова и кеширование проверяйте по документации установленной версии и параметру CLAUDE_CODE_API_KEY_HELPER_TTL_MS.
Как ограничить права временного токена?
Ограничения задаются системой, которая выдаёт токен, а не универсальной настройкой Claude Code. Узнайте у поставщика, можно ли ограничить ресурс и операции, задать срок и отозвать секрет. Если такой возможности нет, используйте отдельную учётную запись с минимальными правами или не передавайте секрет агенту.
Может ли короткий API-ключ запретить чтение файлов на Mac?
Нет. Срок действия ограничивает время использования токена, но не определяет доступ процесса к файлам, командам и сети. Настройте права Claude Code и изоляцию среды отдельно; после работы отзовите токен и проверьте выводы и журналы на случайно раскрытые данные.
Если текущий рабочий процесс держится на постоянном ключе в профиле оболочки, локальной конфигурации или общем Mac, у него есть конкретные издержки: секрет дольше остаётся доступным, его сложнее адресно отозвать, а общий журнал может связать его с несколькими задачами. Для короткого теста можно оставить выполнение на локальном Mac, если доступы проверены и нужные файлы изолированы. Когда требуется отдельная среда для разовой работы, сравните такой подход с удалённым Mac: описание среды ProxyMac поможет оценить вариант удалённого запуска, а раздел помощи ProxyMac — уточнить вопросы по доступу и работе среды. Удалённое выполнение может отделить задачу от личной рабочей станции, но не заменяет минимальные права токена, его отзыв и проверку утечек.