9router/gitbook/content/ja/integration/claude-code.md
2026-05-11 11:50:24 +07:00

3.1 KiB

Claude Code統合

9RouterをClaude Code CLIと統合し、AnthropicのAPIリクエストを9Routerのインテリジェントルーティングシステム経由でルーティングします。

前提条件

  • Claude Code CLIがインストール済み
  • 9Routerがローカルで動作中、またはクラウドエンドポイントが設定済み
  • 9RouterダッシュボードからのAPIキー

セットアップ

1. 環境変数を設定

シェル設定ファイル (~/.bashrc~/.zshrc、または ~/.bash_profile) で以下の環境変数を設定:

# 9Router用Base URL
export ANTHROPIC_BASE_URL="http://localhost:20128/v1"

# オプション: エイリアス用のデフォルトモデルを設定
export ANTHROPIC_DEFAULT_OPUS_MODEL="cc/claude-opus-4-5-20251101"
export ANTHROPIC_DEFAULT_SONNET_MODEL="cc/claude-sonnet-4-5-20250929"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cc/claude-haiku-4-5-20251001"

2. シェル設定をリロード

source ~/.zshrc  # または ~/.bashrc

3. 設定を確認

環境変数が正しく設定されているか確認:

echo $ANTHROPIC_BASE_URL

モデルエイリアス

Claude Codeは9Routerモデルにマッピングされる以下のモデルエイリアスをサポート:

エイリアス モデル 環境変数
opus Claude Opus 4.5 ANTHROPIC_DEFAULT_OPUS_MODEL
sonnet Claude Sonnet 4.5 ANTHROPIC_DEFAULT_SONNET_MODEL
haiku Claude Haiku 4.5 ANTHROPIC_DEFAULT_HAIKU_MODEL

使用例

モデルエイリアスを使用

# Opusモデルを使用
claude --model opus "Explain quantum computing"

# Sonnetモデルを使用
claude --model sonnet "Write a Python function"

# Haikuモデルを使用
claude --model haiku "Quick code review"

フルモデル名を使用

claude --model cc/claude-opus-4-5-20251101 "Your prompt here"

設定ファイル

Claude Codeは設定を ~/.claude/settings.json に保存します。必要に応じてこのファイルを手動で編集できます:

{
  "baseUrl": "http://localhost:20128/v1",
  "defaultModel": "sonnet"
}

トラブルシューティング

接続の問題

接続エラーが発生した場合:

  1. 9Routerが動作中か確認: curl http://localhost:20128/health
  2. 環境変数が正しく設定されているか確認
  3. ファイアウォールがポート20128をブロックしていないか確認

モデルが見つからない

「model not found」エラーが発生した場合:

  1. モデル名が9Routerの設定と一致しているか確認
  2. 9Routerダッシュボードでプロバイダー接続がアクティブか確認
  3. 接続されたプロバイダーでモデルが利用可能か確認

クラウドエンドポイント

localhostの代わりに9Routerクラウドエンドポイントを使用するには:

export ANTHROPIC_BASE_URL="https://9router.com"

9RouterクラウドダッシュボードでAPIキーが設定されていることを確認してください。