APIキーのアカウント

執筆：jhyunwoo
最終更新日: 2026年10月20日
ccam 0.8.0とClaude Code 2.1.302で確認済み

APIキーのアカウントは、Claudeのサブスクリプションのログインの代わりに、APIキーでClaude Codeを起動します。接続先はAnthropicのAPIか、LiteLLMやOpenRouterのゲートウェイのように同じMessages形式を話すエンドポイントです。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キーのアカウントも、ほかのアカウントと同じように設定、CLAUDE.md、拡張機能、MCPサーバーを共有し、ショートカット、ccam folder、ccam extでも使えます。

オプション

オプション	効果	デフォルト
`--api`	ログインする代わりにAPIキーのアカウントを追加します	オフ
`--key-from env:NAME`	環境変数`NAME`からキーを読みます
`--key-from command:COMMAND`	`COMMAND`を実行し（`sh -c`、Windowsでは`cmd /C`）、出力の最初の行を使います
`--base-url <url>`	エンドポイント（`ANTHROPIC_BASE_URL`）	AnthropicのAPI
`--auth api-key\|bearer`	キーを`ANTHROPIC_API_KEY`（`x-api-key`）として送るか、`ANTHROPIC_AUTH_TOKEN`（`Authorization: Bearer`。ゲートウェイは通常こちらを求めます）として送ります	`api-key`
`--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'

しくみ

アカウントを起動するたびに、通常の確認のあと、Claude Codeが起動する前に次のことを行います。

ccamがキーを読みます。env:は環境から、command:はコマンドを30秒の制限時間で実行して読みます。コマンドはターミナルでパスワードを尋ねることができ、エラー出力もターミナルに出ます。キーが空の場合は、キーをどこで探したかを示すメッセージを出して起動を中止します。
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です。ほかの用途でシェルに設定したキーがこのアカウントに届くことはなく、サブスクリプションのログインがこのアカウントのキーより優先されることもありません。
指定があれば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:のソースは起動時に初めて実行されます。
APIキーのアカウントにはログインがないので、ccam loginとccam logoutは拒否します。ccam doctorはエンドポイントとキーのソースを表示し、env:の変数が空なら警告します。
ccam usageではAPIと表示されます。APIキーには比べるべき5時間や週間の上限がないので、ccam next --auto、--fallback、ccam pickはサブスクリプションのアカウントの中からだけ選びます。
envブロックやapiKeyHelperを含む共有のsettings.jsonは、APIキーのアカウントも含め、グループのすべてのアカウントに適用されます。プロバイダーの設定は共有の設定に入れないでください。

使い方

オプション

しくみ

安全性と特殊なケース

関連項目