Claude Code

始める前に

• NezhaGate の API キー（コンソールの「API Keys」ページで作成）。
• Claude Code がインストール済みであること。まだなら次のコマンドを実行します（Node.js 18 以上が必要）：

npm install -g @anthropic-ai/claude-code

ステップ 1：環境変数を設定する

claude を実行するターミナルで設定します。ANTHROPIC_AUTH_TOKEN には NezhaGate のキーを、ANTHROPIC_MODEL には既定で使うモデルを指定します。

export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5
claude

$env:ANTHROPIC_BASE_URL = "https://nezhagate.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5"
claude

この設定は今のターミナルでだけ有効で、新しいターミナルではもう一度設定が必要です。ずっと有効にするには、次のステップの settings.json を使ってください。

ステップ 2（おすすめ）：settings.json に書く

同じ設定を Claude Code のユーザー設定ファイルに書けば、どのターミナルでも有効になります。ファイルの場所は macOS / Linux が ~/.claude/settings.json、Windows が %USERPROFILE%\.claude\settings.json です。ファイルがなければ新しく作ってください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://nezhagate.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

ステップ 3：起動して確認する

プロジェクトのフォルダーで claude を起動し、/status と入力して現在の設定を表示します。ベース URL が https://nezhagate.com/anthropic になっていれば接続できています。

モデルを選ぶ

Claude Code で使えるのは Claude モデルだけです（/anthropic エンドポイントは Claude モデルのみ受け付けます）。現在使えるモデル：

料金は 100 万トークンあたりの米ドルです。

セッション中に /model に続けてモデル ID を入力すると切り替えられます（例：/model claude-opus-5）。/model メニューで Opus や Sonnet を選んだときに使うモデルは、ANTHROPIC_DEFAULT_OPUS_MODEL と ANTHROPIC_DEFAULT_SONNET_MODEL で決まります。

バックグラウンド用のモデル

Claude Code は、会話のタイトル付けなどの小さなバックグラウンド処理を小型モデルに任せ、既定では Claude Haiku を呼び出します。NezhaGate では Haiku を提供していないため、ANTHROPIC_DEFAULT_HAIKU_MODEL で上の表のモデルを指定してください。指定しないと、これらのバックグラウンドのリクエストは 404 になります。

課金とキャッシュ

トークン単位の課金で、/v1 のエンドポイントと同じ料金です。プロンプトキャッシュに当たった部分は表の「キャッシュ読み取り」の料金になり、入力料金よりずっと安くなります。Claude Code は毎ターン同じシステムプロンプトとプロジェクトの文脈を送るため、たいてい毎ターンキャッシュに当たります。

よくあるエラー