Claude Code

環境変数を設定してAnthropicのCLIエージェントをゲートウェイに接続し、気づかないうちに別のキーに課金される落とし穴を回避します。

Claude Codeは環境変数からエンドポイントを読み取るため、パッチを適用する必要はありません。これはゲートウェイで最も一般的な設定方法です。

セットアップ

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

連携に必要な作業はこれだけです。両方の行を次に追加します： ~/.zshrc または ~/.bashrc 設定を永続化できます。

注意すべき落とし穴： もし ANTHROPIC_API_KEY がシェルで設定されていると、Claude Codeがそちらを優先してそのキーに課金し、ゲートウェイのキーやPro/Maxサブスクリプションを通知なく無視することがあります。次を実行します： echo $ANTHROPIC_API_KEY — 何かが表示された場合は、 unset ANTHROPIC_API_KEY を起動前に実行してください。

プロジェクトごとの設定

ゲートウェイの適用範囲をシェル全体ではなく特定のリポジトリに限定するには、設定ファイルを使用します：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

配置先： .claude/settings.json をプロジェクト内で使用するか、 ~/.claude/settings.json をユーザー全体のデフォルトとして使用します。次を追加してください： .claude/settings.json で、変更後の値は .gitignore — キーが含まれているためです。

動作の確認

"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

リクエストがダッシュボードに表示されない場合は、別の送信先に送られています。ほとんどの場合、原因は上記の ANTHROPIC_API_KEY の落とし穴です。

モデルの選択

claude --model claude-opus-4-8

次の取得元に含まれる任意のID：モデルが使えます。難しいリファクタリングにはOpus、日常的な作業にはSonnetを使用します。参照：コスト管理で、この選択が請求額を大きく左右する理由を確認してください。

コストを適切に抑える

Claude Codeはターンごとにファイルの内容とツールの結果を再送信するため、長いセッションではコストが非線形に増加します。次を使用してください： /clear 関連のないタスクの間に実行してください。
大量のツール出力（500行のクエリ結果やビルドログ全体など）は、コンテキストに残り続けます。次のコマンドにパイプで渡してください： head 可能な場合に使用します。
システムプロンプトとツール定義はターン間で変わらないため、この場合はプロンプトキャッシュが特に効果的です。

MCPサーバーClaude Codeに実際のツールを提供する コスト管理エージェントのトークン消費の内訳 トラブルシューティング何も起こらない場合