Cursor で Claude Code を使う：設定・モデル・確認
Cursor 上で Claude Code 拡張機能を AI in IDE の API キー 1 本で動かし、Cursor 自身の AI 機能と課金は分けたままにします。
Cursor は VS Code のフォークなので、拡張機能と設定ファイルは VS Code と同じです。違うのは Cursor の拡張機能レジストリ、設定同期、内蔵 AI です。完全なリファレンスはClaude Code を Cursor で使うを参照してください。
かんたん設定
- Cursor のビルドを確認。 Cursor → About Cursor に VS Code のベース版が表示されます。1.94.0 以降が必要です。
- 拡張機能をインストール。 直接リンク、
Cmd+Shift+X/Ctrl+Shift+Xで Claude Code を検索、またはマーケット表示が絞り込まれている場合は Open VSX Registry から入れます。Spark アイコンが出ないときは Developer: Reload Window を実行します。 - API キーを作成。 API Keys でキーを作り、AWSQ または CCMAX を選びます。Codex や Gemini のキーは別のエンドポイントで認証するため、ここでは失敗します。
- 接続設定を書く。
~/.claude/settings.json（macOS/Linux）またはC:/Users/<UserName>/.claude/settings.json（Windows）を作成、または既存内容に統合します。
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
ベース URL はホスト名だけにします。Cursor と CLI の両方がこのファイルを読み、Cursor の更新、プロファイル切り替え、ウィンドウ再読み込みを越えて維持されます。
- サインイン画面を止める。 Cursor のユーザー
settings.jsonに"claudeCode.disableLoginPrompt": trueを追加します。 - 確認。 キーと
anthropic-version: 2023-06-01でGET /v1/modelsを呼びます。200 はモデル一覧、401 はキー不正、400 は別チャンネルです。パネルを開いて/statusを実行し、短いプロンプトを送ります。Usage でそのキーの使用量を確認します。
Cursor 内での違い
- 2 つのパネル、2 つの課金経路。 Cursor の内蔵チャットとタブ補完は別製品で、このキーを共有しません。Cursor 自身の Claude アクセスは Cursor が課金し、Claude Code パネルは AI in IDE がキーのクォータに対して課金します。タスクごとに一方へ統一しないと、両方のダッシュボードで使用量がずれて見えます。
- プロファイル設定が消えることがある。 Cursor は拡張機能設定を独自プロファイルに保存するため、プロファイル切り替えで
claudeCode.*の値が黙って落ちることがあります。切り替え後に再確認してください。 - プロキシ設定は別。 Cursor の HTTP プロキシと
HTTPS_PROXYは別々に設定されるため、片方の AI クライアントだけ動くことがあります。 - 更新で拡張機能がリセットされることがある。 Cursor 更新後に拡張機能が消えたら、拡張機能ビューから再インストールし、
claudeCode.*設定を入れ直します。 - インデックスが資源を奪う。 最初の応答だけ非常に遅く、その後正常になる場合は、Cursor のインデクサーが CPU とネットワークを飽和させています。
対応モデル
| モデル | チャンネル | 向いている用途 |
|---|---|---|
claude-opus-5-5（別名 claude-opus-5.5） | AWSQ、CCMAX | 複雑なリファクタリング、長時間の自律実行 |
claude-sonnet-5-5（別名 claude-sonnet-5.5） | AWSQ、CCMAX | 日常の既定 |
claude-haiku-4-5-20251001 | AWSQ、CCMAX | 素早い修正、安価な確認 |
model を省くと選択画面を使えます。/model でも切り替えられます。GET /v1/models の正確な ID を使ってください。誤った claude-* 名は既定の Claude モデルに解決され、その料金で請求されることがあります。プランと現在の料金は料金を参照してください。
トラブルシューティングの要点
API Error: 404—ANTHROPIC_BASE_URLに/v1が入っています。ホスト名だけにします。API Error: 400— Cursor が古いビルドを入れたか、settings.jsonが壊れています。Cursor は壊れたファイルを警告なしで無視します。Cursor で開き、$schema行で検証エラーを確認してください。- サインイン画面が再び出る —
/logoutでサインアウトし、disableLoginPromptを設定して再読み込みします。 - 古いトークンが優先される — Cursor の統合ターミナルで
echo $ANTHROPIC_AUTH_TOKENを実行します。古い値が出るなら、それが優先されています。
よくある質問
拡張機能は Cursor で公式にサポートされていますか。
Anthropic は Visual Studio Marketplace と Open VSX に公開し、Cursor をサポート対象のインストール先として文書化しています。ただしインストールは Anthropic が運営しないマーケットを通ります。
Cursor の Claude アクセスとこの拡張機能を両方入れるべきですか。
両方の課金経路が欲しい場合だけです。使用量を揃えたいなら、タスクごとに一方を使ってください。
VS Code のキーと設定を再利用できますか。
はい。Cursor は同じ拡張機能を動かすので、同じキー、settings.json、claudeCode.* 設定が使えます。違いは Cursor のプロファイル管理と独自 AI 機能です。
Cursor のタブ補完はこのキーを使いますか。
いいえ。Cursor の内蔵 AI と Claude Code 拡張機能は別製品で、課金も別です。