Claude 設定

1. Claude Code とは

Claude Code は Anthropic 公式のターミナル型コーディングエージェントです。ローカルプロジェクト内でコードを理解し、ファイルを変更し、コマンドを実行できます。また、VS Code や JetBrains などの IDE と組み合わせて使用できます。

RouteAPI 経由で Claude Code を使用する場合、本質的には Anthropic プロトコルを使い続けながら、Claude Code のリクエスト送信先を RouteAPI の接続先に変更します。これにより、キー、クレジット、利用可能モデルを統一管理しやすくなります。

開始前に、次のものを準備してください。

正常にアクセスできるターミナル環境
インストール済みの Claude Code CLI
あなたの RouteAPI サイトアドレス
あなたの RouteAPI キー
RouteAPI コンソールで利用可能な Claude プロトコルモデル ID

2. ステップ 1: Claude Code をインストールする

CLI をインストールする

macOS / Linux / WSL では、次を直接実行できます。

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell では、次を実行できます。

irm https://claude.ai/install.ps1 | iex

Windows ネイティブ環境にインストールする場合は、通常 Git for Windows も事前に用意する必要があります。

インストール確認

claude --version

バージョン番号が出力されれば、CLI は正常にインストールされています。

3. ステップ 2: RouteAPI を設定する

Claude Code は環境変数から接続先とキーを読み取れます。ターミナルと IDE で同じ設定を共有するため、これらの変数を settings.json に書き込む方法をより推奨します。

3.1 設定ファイルを見つける

macOS / Linux: ~/.claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json

3.2 RouteAPI 接続情報を書き込む

{
  "env": {
"ANTHROPIC_BASE_URL": "https://www.routeapi.ai/",
"ANTHROPIC_AUTH_TOKEN": "あなたの RouteAPI キー"
  }
}

上記の設定では、次の意味になります。

ANTHROPIC_BASE_URL: RouteAPI サイトのルートアドレスを入力します。通常 /v1 は付けません。
ANTHROPIC_AUTH_TOKEN: RouteAPI キーを入力します。Bearer Token 方式で認証するゲートウェイ接続に適しています。

一時的にテストしたいだけの場合は、現在のターミナルセッションで直接環境変数を設定することもできます。使用中の Shell に応じてコマンドを選んでください。

macOS / Linux / WSL の bash、zsh、sh を使用している場合:

export ANTHROPIC_BASE_URL="https://あなたの-routeapi-ドメイン"
export ANTHROPIC_AUTH_TOKEN="あなたの RouteAPI キー"

Windows PowerShell を使用している場合:

$env:ANTHROPIC_BASE_URL="https://あなたの-routeapi-ドメイン"
$env:ANTHROPIC_AUTH_TOKEN="あなたの RouteAPI キー"

設定後は、新しいターミナルウィンドウを開いてから claude を起動するとより確実です。

4. ステップ 3: モデルを選択する

Claude Code のモデル選択には、よく使われる 2 つの方法があります。

方法 A: 既定モデルを固定する

すべてのセッションで同じモデルを既定として使いたい場合は、ANTHROPIC_MODEL を直接設定します。

{
  "env": {
"ANTHROPIC_BASE_URL": "https://あなたの-routeapi-ドメイン",
"ANTHROPIC_AUTH_TOKEN": "あなたの RouteAPI キー",
"ANTHROPIC_MODEL": "コンソールで利用可能なモデル ID"
  }
}

この方法が最もシンプルで、チームで既定モデルを統一する場合に適しています。

方法 B: Opus / Sonnet / Haiku の 3 段階選択を残す

Claude Code 内のモデル段階選択を引き続き使いたい場合は、3 段階それぞれの既定モデルを指定できます。

{
  "env": {
"ANTHROPIC_BASE_URL": "https://あなたの-routeapi-ドメイン",
"ANTHROPIC_AUTH_TOKEN": "あなたの RouteAPI キー",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "あなたの高性能モデル ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "あなたの主力モデル ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "あなたの軽量モデル ID"
  }
}

設定後、Claude Code を起動します。

claude

続いて会話内で次を入力します。

/model

Claude Code 内で、現在のセッションに使うモデル段階を選択できます。