บัญชี API key

บัญชี API key เริ่ม Claude Code ด้วย API key แทนการเข้าสู่ระบบแบบสมัครสมาชิก Claude: API ของ Anthropic หรือ endpoint ที่ใช้รูปแบบ 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 key ใช้การตั้งค่า 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. ccam ลบตัวแปรที่สืบทอดมาทุกตัวที่กำหนดว่า 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 คีย์ที่ตั้งไว้ใน shell เพื่อใช้กับอย่างอื่นจึงไปไม่ถึงบัญชีนี้ และการเข้าสู่ระบบแบบสมัครสมาชิกก็ไม่สามารถชนะคีย์ของบัญชีนี้ได้
3. ccam ตั้ง 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 key เพราะบัญชีนี้ไม่มีการเข้าสู่ระบบ ccam doctor แสดง endpoint และแหล่งของคีย์ และเตือนเมื่อตัวแปร env: ว่าง
• ccam usage แสดง API สำหรับบัญชีนี้ ccam next --auto, --fallback และ ccam pick เลือกจากบัญชีแบบสมัครสมาชิกเท่านั้น เพราะ API key ไม่มีขีดจำกัด 5 ชั่วโมงหรือรายสัปดาห์ให้เปรียบเทียบ
• settings.json ที่ใช้ร่วมกันซึ่งมีบล็อก env หรือ apiKeyHelper จะมีผลกับทุกบัญชีในกลุ่ม รวมถึงบัญชี API key ด้วย อย่าใส่การตั้งค่าผู้ให้บริการไว้ในการตั้งค่าที่ใช้ร่วมกัน

หัวข้อที่เกี่ยวข้อง

• การจัดการบัญชี
• การเริ่ม Claude Code
• ข้อมูลอ้างอิงคำสั่ง