वैशिष्ट्ये

API key खाती

लेखक: jhyunwoo
शेवटचे अपडेट २० ऑक्टोबर, २०२६
ccam 0.8.0 आणि Claude Code 2.1.302 सोबत तपासले

हे पान इंग्रजीतून मशीनद्वारे भाषांतरित केले आहे. दुरुस्त्यांचे स्वागत आहे. हे पान GitHub वर संपादित करा

या पानावर

API key खाते Claude subscription लॉगिनऐवजी API key ने Claude Code सुरू करते: Anthropic चा API, किंवा तोच Messages format समजणारा एखादा endpoint, जसे 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 सह काम करते.

पर्याय

पर्याय काय करते डीफॉल्ट
--api लॉगिन करण्याऐवजी API key खाते जोडा बंद
--key-from env:NAME key environment variable NAME मधून वाचा
--key-from command:COMMAND COMMAND चालवा (sh -c ने, किंवा Windows वर cmd /C ने) आणि ती छापत असलेली पहिली ओळ वापरा
--base-url <url> endpoint (ANTHROPIC_BASE_URL) Anthropic चा API
--auth api-key|bearer key ANTHROPIC_API_KEY (x-api-key) म्हणून किंवा ANTHROPIC_AUTH_TOKEN (Authorization: Bearer, जे gateways सहसा मागतात) म्हणून पाठवा api-key
--model <model> model (ANTHROPIC_MODEL) Claude Code चा डीफॉल्ट

या सेटिंग्ज 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. Claude Code कसे sign in करते किंवा कोणता provider वापरते हे ठरवणारा प्रत्येक वारशाने मिळालेला variable ते काढून टाकते: 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 सेटिंग्ज शेअर केलेल्या सेटिंग्जबाहेर ठेवा.