【結論】APIキーを安全にセットアップする
Claude CodeはAPIキー以外に、対応するClaudeサブスクリプションやCloud provider認証も利用できます。
API課金を選ぶ場合だけANTHROPIC_API_KEYを設定し、Secret Managerから一時注入します。
環境変数のAPIキーはサブスクリプション認証より優先されるため、意図しないAPI請求を避けるには/statusで実際の認証方式を確認します。
# ターミナルで実行：一時設定
export ANTHROPIC_API_KEY="${YOUR_ANTHROPIC_API_KEY}"
# ターミナルで実行：設定有無だけ確認
test -n "$ANTHROPIC_API_KEY" && echo "API key is set"
# ターミナルで実行：Claude Codeを開始
claude
# 起動後のセッション内で実行：認証を確認
/status具体的な手順・設定方法
Anthropic Consoleで用途別のAPIキーを作成し、最小権限の組織・Workspaceへ紐づけます。
ローカルではKeychainなどから起動時だけ値を渡します。
CIでは保護Environment、Masking、Rotationを組み合わせます。
設定後は
/statusでAPI keyが選ばれていることを確認し、不要ならunset ANTHROPIC_API_KEYでサブスクリプション認証へ戻します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
現在の認証方式と認証を確認可能な範囲で説明してください。
APIキーの値は表示せず、環境変数がサブスクリプション認証より優先されているかだけ報告してください。
ファイル変更と外部送信は行わないでください。注意点・よくあるエラーと対処法
echo $ANTHROPIC_API_KEYで秘密値を表示するとTerminal logや画面共有へ残るため避けてください。
シェル履歴へ実キーを直接入力した場合は履歴削除だけで済ませず、対象キーを失効して再発行します。
401は失効、Organization、Proxy、請求不一致でも発生します。