Аккаунты с ключом API

Аккаунт с ключом API запускает Claude Code с ключом API вместо входа по подписке Claude: для API Anthropic или для эндпоинта, который понимает тот же формат Messages, например шлюза LiteLLM или OpenRouter. ccam не хранит ключ. Он читает его при каждом запуске аккаунта из переменной окружения или из команды, например менеджера паролей, и передаёт его только этому процессу Claude Code.

Использование

ccam add api --api --key-from env:ANTHROPIC_KEY_WORK
ccam add gw --api --base-url https://llm.example.com --auth bearer \
  --model claude-sonnet-5-5 --key-from 'command:pass show llm/gateway-key'
ccam add mac --api --key-from 'command:security find-generic-password -s anthropic-api -w'
ccam gw -p "summarise the open issues"
ccam list

$ ccam list
   #  Name      Shortcut  Email                    Shared               Last used
*  1  personal  -         me@example.com           mcp settings md ext  2h ago
   2  gw        -         (API: llm.example.com)   mcp settings md ext  -

Аккаунт с ключом API делит настройки, CLAUDE.md, расширения и MCP-серверы, как любой другой аккаунт, и работает с короткими командами, ccam folder и ccam ext.

Параметры

Настройки хранятся в config.toml:

[[profile]]
name = 'gw'
slot = 2

[profile.api]
base_url = 'https://llm.example.com'
key_from = 'command:pass show llm/gateway-key'
auth = 'bearer'
model = 'claude-sonnet-5-5'

Как это работает

При каждом запуске аккаунта, после обычных проверок и до старта Claude Code:

1. ccam читает ключ: env: из окружения, command: выполнением команды с ограничением в 30 секунд. Команда может запросить пароль в терминале; её поток ошибок тоже идёт в терминал. Пустой ключ останавливает запуск с сообщением о том, где ожидался ключ.
2. Он удаляет все унаследованные переменные, которые определяют, как Claude Code выполняет вход или какого провайдера использует: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX и CLAUDE_CODE_USE_FOUNDRY. Ключ, заданный в вашей оболочке для чего-то другого, не попадёт в этот аккаунт, а вход по подписке не возьмёт верх над его ключом.
3. Он задаёт ANTHROPIC_BASE_URL и ANTHROPIC_MODEL, если они указаны, а ключ — как ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN.

Аккаунты со входом по подписке, как и раньше, получают унаследованное окружение. В интерактивной сессии Claude Code может один раз спросить, использовать ли ключ, найденный в окружении.

Безопасность и особые случаи

• Ключ никогда не записывается в config.toml, кэш или журнал, а ccam --dry-run gw его не читает: источник command: при пробном запуске не выполняется.
• ccam add --api сразу проверяет источник env: и предупреждает, если переменная пуста; источник command: впервые выполняется при запуске.
• ccam login и ccam logout отказываются работать с аккаунтом с ключом API, поскольку у него нет входа. ccam doctor показывает его эндпоинт и источник ключа и предупреждает, если переменная env: пуста.
• ccam usage показывает для него API. ccam next --auto, --fallback и ccam pick выбирают только среди аккаунтов с подпиской, потому что у ключа API нет 5-часового или недельного лимита для сравнения.
• Общий settings.json с блоком env или apiKeyHelper применяется к каждому аккаунту группы, включая аккаунты с ключом API. Не храните настройки провайдера в общих настройках.

См. также

• Управление аккаунтами
• Запуск Claude Code
• Справочник команд