Claude Code の設定

Claude Code は Anthropic Messages 互換プロトコルで InOneAPI に接続できます。認証・プロトコル処理・計量・ルーティングは InOneAPI が担当し、Claude Code のファイルアクセス、コマンド実行、権限付与はローカルのクライアント側で管理されます。

事前準備

Claude Code 専用のプロジェクトキーを作成し、モデル詳細ページから Anthropic Messages・ストリーミング・ツール呼び出しに対応したモデル ID をコピーします。対応機能はプロトコルごとに異なるため、モデル名だけで判断せずモデル詳細ページで確認してください。

設定の書き込み

Windows のパスは %USERPROFILE%\.claude\settings.json です。CLAUDE_CONFIG_DIR を設定している場合はそのディレクトリを使用します。~/.claude/settings.json を作成または開き、env 項目を既存の JSON にマージします：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inoneapi.com",
    "ANTHROPIC_AUTH_TOKEN": "ioa_sk_...",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID"
  }
}

ANTHROPIC_BASE_URL に /v1 は追加しないでください。Claude Code が Messages のパスを要求します。4 つのモデル変数に同じ ID を指定すると、タスクの段階ごとに未設定の既定モデルへ戻るのを防げます。

キーを JSON に保存したくない場合は、シェルで ANTHROPIC_AUTH_TOKEN を設定し、settings.json からその項目を削除します：

export ANTHROPIC_AUTH_TOKEN="ioa_sk_..."

起動と検証

claude

最初に読み取り専用タスクを実行し、その後コンソールのトレースを確認します。リクエスト先のモデルが設定どおりか、インターフェースが Anthropic Messages か、ストリーミングが正常か、ツール呼び出しでプロトコル変換エラーが出ていないかをチェックしてください。

よくある問題

  • ログイン要求が繰り返し表示される：設定しているのが ANTHROPIC_AUTH_TOKEN かどうかを確認し、Claude Code を完全に終了してから再起動します。
  • 401：キー、プロジェクトの状態、環境変数が古い値で上書きされていないかを確認します。
  • 404：Base URL の誤り、またはモデル ID が存在しないことが原因です。ここでの Base URL に /v1 は含めません。
  • ツール呼び出しが失敗する：モデル詳細ページでツール呼び出しと Anthropic Messages への対応が明記されているモデルに切り替えます。
  • 費用が想定より大きい：Claude Code はファイルを並列読み込みしたり再試行する可能性があるため、専用キーに予算とアラートを設定します。

実際のキーを含む settings.json をチームのリポジトリに同期しないでください。チームメンバーは、追跡可能な個人またはチームのサブキーを各自で使用します。

任意：CC Switch にインポート

モデル詳細ページで本ツールと API キーを選択し、「CC Switch を開いてインポート」をクリックします。CC Switch 公式版 を使用してください。インポートリンクには現在のモデル ID が含まれるため、再入力する必要はありません。インポートを確認した後、本ツールのプロバイダー有効化と既定モデルの設定で接続を完了します。app 非対応と表示された場合は、CC Switch を更新するか本文の手動設定に従ってください。

インポートリンクはプロバイダーを追加するだけで、既定モデルの設定や正常なリクエストを保証するものではありません。リンクには API キーが含まれるため、共有しないでください。手動設定と CC Switch インポートはどちらか一方だけで構いません。

CC Switch のリンクは model、haikuModel、sonnetModel、opusModel も同時に渡します。いずれも現在のモデル ID を使用し、手動設定と同じ内容です。

公式リファレンス：Claude Code LLM Gateway。

Claude Code · ドキュメント · InOneAPI