Browse documentation
Cursor で Claude Code を使う
Cursor 上で Claude Code 拡張機能を、AI in IDE の API キー 1 本で動かします。
Cursor は VS Code のフォークなので、公式拡張機能はそのままインストールでき、動作も同じです。ただし Cursor は独自の AI 機能、独自の拡張機能レジストリ、独自の設定同期を持っており、この 3 点がトラブルシューティングの内容を変えます。
素の VS Code を使っている場合はClaude Code を VS Code で使うを読んでください。設定ブロックは同一で、一般的なケースはそちらで網羅しています。このページは Cursor 内部での違いに絞ります。
バージョンと前提条件
| 項目 | 要件 | 補足 |
|---|---|---|
| Cursor | VS Code 1.94.0 以降をベースにしたビルド | Cursor → About Cursor に VS Code のベース版が出ます |
| Claude Code 拡張機能 | Open VSX または内蔵マーケットの最新版 | バージョンは同梱 CLI に追随 |
| AI in IDE のキー | AWSQ または CCMAX チャンネル | ダッシュボード |
| Anthropic アカウント | 不要 | API キーがログインの代わり |
Cursor も拡張機能も、claude を PATH に置きません。ターミナルセッションや claude mcp add を使う場合だけ CLI を別途インストールします。
拡張機能をインストールする
- 直接インストール：Install for Cursor。Cursor が拡張機能 ID を解決し、その後に通常の確認手順が出ます。
- 手動：
Cmd+Shift+X/Ctrl+Shift+Xで Claude Code を検索し インストール。 - 検索しても出ない場合：Cursor のマーケット表示が絞り込まれている可能性があります。Open VSX Registry からインストールしてください。Visual Studio Marketplace を使えないフォーク向けに公開された同一ビルドです。
インストール後に Spark アイコンが出ない場合は Developer: Reload Window を実行します。アイコンはファイルを開いているときだけ表示され、フォルダーを開いただけでは出ません。
API キーを作成してコピーする
API Keys を開いてキーを作成し、チャンネルで AWSQ か CCMAX を選びます。これが Claude Code 用のチャンネルで、Codex や Gemini のキーは別のエンドポイントで認証するためここでは失敗します。あとから API Keys の一覧でキー全体を表示したり、コピーしたりできます。
以下の例では YOUR_DASHBOARD_API_KEY をその値の置き場所として使います。
設定
1. 接続設定
~/.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 }
ANTHROPIC_BASE_URL はホスト名で止めます。Claude Code が /v1/messages を自分で付けるため、ここに /v1 を足すと /v1/v1/messages になります。
このファイルは拡張機能と CLI が共有するので、プロキシ構成を置く場所として正解です。Cursor の更新、プロファイル切り替え、ウィンドウの再読み込みを越えて残ります。
2. サインイン画面を止める
拡張機能は claude.ai アカウントを前提にしています。Cursor のユーザー settings.json（Cmd+, / Ctrl+,）に追加します。
1 "claudeCode.disableLoginPrompt": true
これがないと、初回にパネルを開いた時点で Sign in が表示され、拡張機能がベース URL に到達しません。
3. Cursor 自身の AI と混同しない
Cursor 内蔵のチャットと Tab 補完は別製品で、このキーを共有しません。実務上の影響は 2 つです。
- パネルが 2 つ、課金経路も 2 つ。 Cursor 自身の Claude アクセスは Cursor が課金し、Claude Code パネルは AI in IDE がキーのクォータに対して課金します。作業ごとにどちらか一方に統一しないと、両方のダッシュボードの使用量が読めなくなります。
settings.jsonの衝突。 Cursor は拡張機能の設定を独自のプロファイルに保存するため、プロファイルを切り替えるとclaudeCode.*の値が黙って消えることがあります。切り替え後に必ず確認してください。
4. 任意：モデルとシェルの一致
1 {2 "model": "claude-sonnet-5-5",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY"6 }7 }
macOS で Dock から起動した Cursor はシェルのプロファイルではなくシステム環境を引き継ぐため、~/.zshrc の export は統合ターミナルには届いてもチャットパネルには届きません。上のファイルがその解決策です。シェルの export に頼るなら、ターミナルから cursor . で起動すれば引き継がれます。
動作確認
最初にモデル一覧を取得し、キーと Claude チャンネルを確認します。このリクエストではクォータを消費しません。
1 curl --globoff -i 'https://api.aiinide.com/v1/models' \2 -H "x-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "anthropic-version: 2023-06-01"
HTTP 200 ならモデル一覧が返ります。401 はキーの未指定、無効、または期限切れ、400 はチャンネルの不一致を示します。以下の Messages の例では一覧のモデル ID を指定してください。
- サインイン画面なしでパネルが開く。 Spark アイコンからパネルを開きます。ここでサインインを求められたら、
disableLoginPromptがユーザー設定に入っていません。 /statusを入力欄で実行し、バージョンとモデルを確認します。- エディタで短い質問を送り、ダッシュボードでそのキーの使用量を確認します。
- 確認済みのキーでモデルを直接呼び出します。
1 curl --globoff 'https://api.aiinide.com/v1/messages' \2 -H "x-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "anthropic-version: 2023-06-01" \4 -H "Content-Type: application/json" \5 -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
- 使用量。 成功したプロンプトのあと、使用量ページのそのキーの数値が増えます。
トラブルシューティング
GET /v1/models が返す正確な ID を指定してください。claude-* の名前を誤入力すると、設定済みの既定の Claude モデルに切り替わり、そのモデルの料金が発生する場合があります。
API Error: 404
ANTHROPIC_BASE_URL は https://api.aiinide.com に設定します。/v1 を追加するとリクエスト先が /v1/v1/messages になり、404 が返ります。
API Error: 400
- Cursor に古いビルドが入っている。 フォーク専用レジストリ由来の古い拡張機能は遅れていることがあります。拡張機能ビューで更新して再読み込みしてください。
settings.jsonの書式エラー。 Cursor はファイルが壊れたことを教えず、単に無視します。Cursor で開いてください。$schemaの行があれば検証エラーがその場で表示されます。
API キーの確認
キーの確認には GET /v1/models のステータスを使います。ネイティブの POST /v1/messages はキーが未指定または無効でも HTTP 200 を返し、content に認証エラーが入る場合があります。
- サインインが残っている。 以前 Claude アカウントでサインインしていたら
/logoutし、disableLoginPromptを設定して再読み込みします。 - 環境に別の
ANTHROPIC_AUTH_TOKENがある。 Cursor の環境はシェル、プロファイル、起動エージェントから供給され得ます。Cursor の統合ターミナルでecho $ANTHROPIC_AUTH_TOKENを実行し、古い値が出るならそれが優先されています。 - キーの期限切れ、またはチャンネル変更。 CCMAX から Codex に変えたキーはここで必ず失敗します。チャンネルを書き換えるのではなく作り直してください。
Cursor 固有のネットワーク問題
| 症状 | 原因 | 対処 |
|---|---|---|
| パネルは動くが Tab 補完が失敗する（またはその逆） | 2 つの AI クライアントの片方にしかプロキシ設定がない | Cursor の HTTP プロキシと HTTPS_PROXY は別々の設定です。両方設定してください |
| Cursor の更新後に拡張機能が消える | プロファイルがリセットされた | 拡張機能ビューから入れ直し、claudeCode.* の設定も戻す |
| 最初の応答だけ極端に遅く、その後は普通 | Cursor のインデクサーが CPU とネットワークを占有 | インデックス完了を待つか、大きなディレクトリを除外 |
Cursor だけで Certificate is not trusted | TLS を検査するプロキシの CA を Cursor が信頼していない | settings.json の env に NODE_EXTRA_CA_CERTS を追加し、プロキシのルート CA を指定 |
| Remote-SSH ウィンドウでタイムアウトまで固まる | 設定がローカルに残っている | リモートホスト側の ~/.claude/settings.json を編集 |
他の拡張機能との衝突
Cursor 環境では複数の AI 拡張機能が同時に入っていることがよくあります。チャットパネルや同じキーボードショートカットを登録する 2 つは競合します。Cmd+Esc が Claude Code ではなく Cursor 自身のチャットを開いたり、ツールバーの Spark アイコンが隠れたりします。まず相手を一時的に無効にして原因を確認し、どちらか一方に絞るか、キーボードショートカットエディターで再割り当てしてください。
モデルと料金
| モデル | チャンネル | 用途 |
|---|---|---|
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 | 素早い修正、安価なチェック |
Opus 5.5 の表示価格は 100 万トークンあたり入力 $4、キャッシュ読み取り $0.20、出力 $20 です。クォータ消費は AWSQ が 0.8 倍、CCMAX が 2 倍。上流が Fast モードで処理した場合は基本料金とキャッシュ料金が 2 倍になります。
- プランとクォータ：料金
- キー管理：API Keys
- エンドポイントと料率：設定
- 公式の拡張機能リファレンス：code.claude.com VS Code（Cursor 対応も同じページに記載）
よくある質問
Cursor は公式サポートですか。 Anthropic は拡張機能を Visual Studio Marketplace と Open VSX に公開し、Cursor をインストール先として文書化しています。Anthropic 側から見ればマーケットプレイスは第三者のソフトウェアで、Anthropic が運営しているわけではありません。
Cursor 自身の Claude アクセスとこの拡張機能を両方入れるべきですか。 2 つの課金経路を並行させたい場合だけです。使用量を一貫させたいなら片方に統一してください。
キーを同僚と共有できますか。 個人キーを共有するのではなく、キーのクォータと有効期限で配分し、使用量ページでキーごとに確認してください。