Claude Code

Claude Code は、Anthropic のコーディング用 AI ツールです。ターミナルや VS Code で動きます。Claude Code は Anthropic 形式で Echo に接続します。

動作確認：Claude Code 2.1.278（2026-09-27、Echo の検証環境）

始める前に

• Claude Code で使うのは Claude のモデルです。Anthropic は、Echo のような中継サービス（ゲートウェイ）を経由して Claude 以外のモデルを使う構成をサポートしていません。また、ゲートウェイ製品を推奨・保守・監査していません
• Echo のキーを設定している間は、claude.ai のサブスクリプションは使われません。料金は Echo の残高から差し引きます
• Echo の API キーと、使う Claude のモデルの ID を用意します。提供する Claude のモデルとその ID は、モデル一覧で確認できます

設定する

ターミナルで設定する

次の環境変数（パソコンに設定しておく名前付きの値）を設定します。sk-... は Echo の API キーに、モデル ID は使うモデルの ID に置き換えます。

export ANTHROPIC_BASE_URL="https://token.echohub.io"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

• モデル ID を設定しないと、Claude Code は自分の既定のモデル ID で呼び出します。その ID を Echo が提供していない場合はエラーになり、表示されるまで 1 分以上かかります（下の「確認されている問題」）
• ANTHROPIC_DEFAULT_OPUS_MODEL などの 3 つにも、Echo が提供しているモデルの ID を入れます。提供していない ID を入れると、そのモデルを使う場面でエラーになります
• ANTHROPIC_API_KEY に別のキー（Anthropic のキーなど）が入っている場合は、削除してから設定します。Claude Code はこの変数のキーを x-api-key ヘッダーで送ります

設定ファイルに書く

毎回設定しない場合は、~/.claude/settings.json（Windows は %USERPROFILE%\.claude\settings.json）の env に書きます。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token.echohub.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

シェルと設定ファイルの両方で同じ変数を設定した場合は、設定ファイルの値が使われます。

注意：プロジェクトの .claude/settings.json にはキーを書かないでください。このファイルはリポジトリに入り、ほかの人にも共有されます。

VS Code の拡張機能で使う

VS Code のユーザー設定（コマンド「Preferences: Open User Settings (JSON)」で開きます）の claudeCode.environmentVariables に書きます。拡張機能は、起動前にこの設定の認証情報を確認します。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://token.echohub.io" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" }
  ]
}

動作を確かめる

1. 環境変数を設定したターミナルで、次のコマンドを実行します。最後の行に 200 が表示され、その上に "type":"message" を含む JSON が表示されれば、接続先とキーは正しく設定されています

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "こんにちは"}]}'

2. 同じターミナルで claude を起動し、/status を実行します。接続先が https://token.echohub.io になっていること、認証情報として ANTHROPIC_AUTH_TOKEN が表示されていることを確認します
3. 何か話しかけて、エラーなく回答が返れば完了です。コンソールの「呼び出し履歴」にも記録が出ます

確認されている問題

2026-09-27 に Echo の検証環境で確認した動作です。

経由先の API がエラーを返す状況と、エラー本文の一覧はエラーと対処にあります。

うまくいかないとき

Claude Code は、リクエストに端末とセッションを区別する ID を付けて送ります。Echo はこの値を変えずに経由先の Anthropic に渡します。詳しくはデータの取り扱いにあります。

確認した情報源