API key अकाउंट

API key अकाउंट Claude subscription लॉगिन के बजाय API key से Claude Code शुरू करता है: Anthropic का API, या कोई ऐसा endpoint जो वही Messages format समझता है, जैसे LiteLLM या OpenRouter gateway। ccam key सेव नहीं करता। अकाउंट जब भी शुरू होता है, यह key किसी environment variable से या password manager जैसी किसी कमांड से पढ़ता है, और उसे केवल उसी Claude Code process को देता है।

उपयोग

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 key अकाउंट किसी भी दूसरे अकाउंट की तरह सेटिंग्स, CLAUDE.md, extensions और 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'

यह कैसे काम करता है

अकाउंट के हर launch पर, सामान्य जाँचों के बाद और Claude Code शुरू होने से पहले:

1. ccam key पढ़ता है: env: को environment से, command: को 30 सेकंड की सीमा के साथ कमांड चलाकर। कोई कमांड terminal पर password माँग सकती है; उसका error output भी terminal पर जाता है। ख़ाली key launch को रोक देती है, एक संदेश के साथ जो बताता है कि key कहाँ अपेक्षित थी।
2. यह हर विरासत में मिला variable हटाता है जो तय करता है कि Claude Code कैसे sign in करता है या कौन-सा provider इस्तेमाल करता है: 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। आपके shell में किसी और काम के लिए सेट की गई key इस अकाउंट तक नहीं पहुँच सकती, और कोई subscription लॉगिन इसकी key पर हावी नहीं हो सकता।
3. दिए जाने पर यह ANTHROPIC_BASE_URL और ANTHROPIC_MODEL सेट करता है, और key को ANTHROPIC_API_KEY या ANTHROPIC_AUTH_TOKEN के रूप में।

subscription लॉगिन वाले अकाउंट पहले की तरह विरासत में मिला environment ही रखते हैं। interactive session में Claude Code एक बार पूछ सकता है कि environment में मिली key इस्तेमाल करनी है या नहीं।

सुरक्षा और विशेष स्थितियाँ

• key कभी config.toml, किसी cache या log में नहीं लिखी जाती, और ccam --dry-run gw उसे नहीं पढ़ता: dry run में command: source नहीं चलाया जाता।
• ccam add --api किसी env: source को तुरंत जाँचता है और variable ख़ाली होने पर चेतावनी देता है; command: source पहली बार launch पर चलता है।
• ccam login और ccam logout API key अकाउंट को मना कर देते हैं, क्योंकि उसका कोई लॉगिन नहीं होता। ccam doctor उसका endpoint और key source दिखाता है, और env: variable ख़ाली होने पर चेतावनी देता है।
• ccam usage उसके लिए API दिखाता है। ccam next --auto, --fallback और ccam pick केवल subscription अकाउंट्स में से चुनते हैं, क्योंकि API key की तुलना करने लायक कोई 5 घंटे या साप्ताहिक सीमा नहीं होती।
• env block या apiKeyHelper वाला साझा settings.json ग्रुप के हर अकाउंट पर लागू होता है, API key अकाउंट्स पर भी। provider की सेटिंग्स को साझा सेटिंग्स से बाहर रखें।

संबंधित

• अकाउंट प्रबंधित करना
• Claude Code शुरू करना
• कमांड संदर्भ