Anthropic 公式の Claude Code 拡張機能（2.0+）は、VS Code の settings.json で中継 URL を直接設定でき、システム環境変数に依存しません。Windows / macOS / Linux で使い方は同じです。

Cursor と Windsurf はどちらも VS Code ベースのため、設定方法は同じです。

1. 拡張機能のインストール

拡張機能パネルで Claude Code を検索し、Anthropic 公開のものをインストールします。

2. settings.json を開く

コマンドパレットから開くのが最も確実で速い方法です。

コマンドパレットを開く：
- Windows / Linux：Ctrl + Shift + P
- macOS：Cmd + Shift + P（⇧⌘P）
Preferences: Open User Settings (JSON) と入力して Enter。

Ctrl/Cmd + Shift + P が効かない場合（IME や他ツールに横取りされることが多い）、Ctrl + P / Cmd + P で「クイックオープン」を開き、入力欄の先頭文字として >（大なり）を入力してコマンドパレットに切り替え、同じコマンドを検索してください。

3. 設定を追加

settings.json のトップレベルオブジェクトに claudeCode.environmentVariables を追加します。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" }
  ]
}

既存の設定がある場合はマージしてください。別のキーの下にネストしないでください。

Claude Code パネルで ChatGPT gpt-5.6-sol を超高推論で使う場合は、モデルと推論 effort の変数も追加します。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "gpt-5.6-sol" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME", "value": "4AICode GPT 5.6 Sol" },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES",
      "value": "effort,xhigh_effort,thinking,adaptive_thinking,interleaved_thinking"
    },
    { "name": "ANTHROPIC_MODEL", "value": "opus" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "gpt-5.4-mini" },
    { "name": "CLAUDE_CODE_EFFORT_LEVEL", "value": "xhigh" }
  ]
}

ANTHROPIC_DEFAULT_OPUS_MODEL は Claude Code の opus エイリアスを gpt-5.6-sol にマップし、CLAUDE_CODE_EFFORT_LEVEL=xhigh は超高推論に対応します。

GPT-6 Astra を使う場合は ANTHROPIC_DEFAULT_OPUS_MODEL を gpt-6-astra に設定；表示名を 4AICode GPT 6 Astra にしても構いません。

ゲートウェイはリクエストされた gpt-* または claude-* モデル名で上流サービスを選択します。現在の可用性はコンソールで確認してください。

4. VS Code を再起動

完全に終了してから開き直してください（ウィンドウを閉じるだけでは不十分；変数はプロセス起動時に一度だけ読み込まれ、その後は更新されません）。

Windows：File → Exit / Alt + F4、システムトレイとタスクマネージャーで Code.exe プロセスがすべて終了したことを確認
macOS：Cmd + Q
Linux：File → Exit

Cursor / Windsurf も同様です。

5. 動作確認

左側の Claude Code パネルを開き（拡張機能インストール後に Anthropic アイコンが表示されます）、ping を送信します。応答があれば接続成功です。

次にダッシュボード → 利用記録で対応するリクエストを確認してください。

FAQ

Q: まだ「Welcome to Claude Code」のサインイン画面が出る？

3 つのボタン（Claude.ai Subscription / Anthropic Console / Bedrock）はクリックしないでください。クリックすると公式サービスとの OAuth が始まり、その後 claude logout でローカルログイン状態をクリアして 4AICode に戻る必要があります。最も多い原因：

claudeCode.environmentVariables のスペルミスまたは別キー下へのネスト — settings.json を確認
VS Code を完全再起動していない — システムトレイとタスクマネージャーですべての Code.exe を終了してから開き直す
ANTHROPIC_AUTH_TOKEN の代わりに ANTHROPIC_API_KEY を使った — 2.0 拡張機能は後者をより確実に認識

Q: Cursor 独自の Chat / Agent と競合しますか？

いいえ。Claude Code は別パネルです。Cursor 組み込みの Chat / Agent / Tab は Cursor 独自のバックエンドを使うため、互いに影響しません。

Q: ワークスペース設定とユーザー設定？

ユーザーレベル（上記の Preferences: Open User Settings (JSON)）での設定を推奨し、すべてのプロジェクトで共有します。1 プロジェクトのみに適用する場合は Preferences: Open Workspace Settings (JSON) を使い、プロジェクトの .vscode/settings.json に書き込みます。

⚠️ ワークスペース設定を git にコミットしないでください。トークンが露出する可能性があります。

VS Code / Cursor / Windsurf で 4AICode を使う

1. 拡張機能のインストール

2. settings.json を開く

3. 設定を追加

4. VS Code を再起動

5. 動作確認

FAQ