Tài khoản API key

Tài khoản API key khởi động Claude Code bằng một API key thay cho đăng nhập gói đăng ký Claude: API của Anthropic, hoặc một endpoint dùng cùng định dạng Messages, chẳng hạn một gateway LiteLLM hay OpenRouter. ccam không lưu khóa. Nó đọc khóa mỗi lần tài khoản khởi động, từ một biến môi trường hoặc từ một lệnh như trình quản lý mật khẩu, và chỉ trao khóa cho tiến trình Claude Code đó.

Cách dùng

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  -

Tài khoản API key dùng chung cài đặt, CLAUDE.md, tiện ích mở rộng và máy chủ MCP như mọi tài khoản khác, và hoạt động với lệnh tắt, ccam folder và ccam ext.

Tùy chọn

Các thiết lập được lưu trong 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'

Cách hoạt động

Mỗi lần khởi động tài khoản, sau các bước kiểm tra thông thường và trước khi Claude Code khởi động:

1. ccam đọc khóa: env: từ môi trường, command: bằng cách chạy lệnh với giới hạn 30 giây. Lệnh có thể hỏi mật khẩu trên terminal; đầu ra lỗi của nó cũng đi tới terminal. Một khóa rỗng sẽ dừng việc khởi động với thông báo cho biết khóa được chờ đợi ở đâu.
2. Nó xóa mọi biến kế thừa quyết định cách Claude Code đăng nhập hoặc nhà cung cấp nào được dùng: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX và CLAUDE_CODE_USE_FOUNDRY. Một khóa đặt trong shell cho việc khác không thể tới được tài khoản này, và một đăng nhập gói đăng ký không thể lấn át khóa của nó.
3. Nó đặt ANTHROPIC_BASE_URL và ANTHROPIC_MODEL khi được cung cấp, và đặt khóa thành ANTHROPIC_API_KEY hoặc ANTHROPIC_AUTH_TOKEN.

Các tài khoản đăng nhập bằng gói đăng ký vẫn giữ môi trường mà chúng kế thừa, như trước. Trong một phiên tương tác, Claude Code có thể hỏi một lần có dùng khóa nó tìm thấy trong môi trường hay không.

An toàn và các trường hợp đặc biệt

• Khóa không bao giờ được ghi vào config.toml, bộ nhớ đệm hay nhật ký, và ccam --dry-run gw không đọc nó: chạy thử không chạy nguồn command:.
• ccam add --api kiểm tra nguồn env: ngay lập tức và cảnh báo nếu biến rỗng; nguồn command: được chạy lần đầu khi khởi động.
• ccam login và ccam logout từ chối tài khoản API key, vì nó không có đăng nhập. ccam doctor hiển thị endpoint và nguồn khóa của nó, và cảnh báo khi một biến env: rỗng.
• ccam usage hiển thị API cho nó. ccam next --auto, --fallback và ccam pick chỉ chọn trong các tài khoản gói đăng ký, vì API key không có giới hạn 5 giờ hay hàng tuần để so sánh.
• Một settings.json dùng chung có khối env hoặc apiKeyHelper sẽ áp dụng cho mọi tài khoản trong nhóm, kể cả tài khoản API key. Đừng đặt thiết lập nhà cung cấp trong cài đặt dùng chung.

Liên quan

• Quản lý tài khoản
• Khởi động Claude Code
• Tham chiếu lệnh