Mga API key account

Sinisimulan ng isang API key account ang Claude Code gamit ang API key sa halip na Claude subscription login: ang API ng Anthropic, o isang endpoint na gumagamit ng parehong Messages format, gaya ng LiteLLM o OpenRouter gateway. Hindi iniimbak ng ccam ang key. Binabasa nito ang key sa bawat pagsisimula ng account, mula sa isang environment variable o sa isang command gaya ng password manager, at ibinibigay lang ito sa prosesong iyon ng Claude Code.

Paggamit

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  -

Nagshe-share ang isang API key account ng settings, CLAUDE.md, mga extension at mga MCP server gaya ng ibang account, at gumagana ito sa mga shortcut, sa ccam folder at sa ccam ext.

Mga option

Iniimbak ang mga setting sa 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'

Paano ito gumagana

Sa bawat pagsisimula ng account, pagkatapos ng karaniwang mga pagsusuri at bago magsimula ang Claude Code:

1. Binabasa ng ccam ang key: ang env: mula sa environment, ang command: sa pagpapatakbo ng command na may 30-segundong limit. Puwedeng humingi ng password sa terminal ang command; napupunta rin sa terminal ang error output nito. Pinapahinto ng walang laman na key ang pagsisimula na may mensaheng nagsasabi kung saan inaasahan ang key.
2. Inaalis nito ang bawat minanang variable na nagpapasya kung paano magsa-sign in ang Claude Code o kung aling provider ang gagamitin nito: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX at CLAUDE_CODE_USE_FOUNDRY. Hindi makakarating sa account na ito ang key na itinakda sa shell mo para sa ibang bagay, at hindi matatalo ng subscription login ang key nito.
3. Itinatakda nito ang ANTHROPIC_BASE_URL at ANTHROPIC_MODEL kapag ibinigay, at ang key bilang ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN.

Pinananatili ng mga account na may subscription login ang environment na minana nila, gaya ng dati. Sa isang interactive session, puwedeng magtanong nang isang beses ang Claude Code kung gagamitin ang key na nakita nito sa environment.

Kaligtasan at mga espesyal na kaso

• Hindi kailanman isinusulat ang key sa config.toml, sa cache o sa log, at hindi ito binabasa ng ccam --dry-run gw: hindi pinapatakbo ng dry run ang command: na source.
• Agad na sinusuri ng ccam add --api ang env: na source at nagbababala kapag walang laman ang variable; unang pinapatakbo ang command: na source sa pagsisimula.
• Tinatanggihan ng ccam login at ccam logout ang API key account, dahil wala itong login. Ipinapakita ng ccam doctor ang endpoint at key source nito, at nagbababala kapag walang laman ang env: na variable.
• Ipinapakita ng ccam usage ang API para rito. Pumipili lang ang ccam next --auto, --fallback at ccam pick sa mga subscription account, dahil walang 5-oras o lingguhang limit ang API key na maikukumpara.
• Nalalapat sa bawat account sa group, kasama ang mga API key account, ang shared na settings.json na may env block o apiKeyHelper. Huwag ilagay ang mga setting ng provider sa shared na settings.

Kaugnay

• Pamamahala ng mga account
• Pagsisimula ng Claude Code
• Sanggunian ng mga command