VS Code で Claude Code を使用する
Claude Code 拡張機能を VS Code にインストールして設定します。インラインの差分表示、@-メンション、プラン確認、キーボードショートカットを使用した AI コーディング支援を取得します。
VS Code 拡張機能は、Claude Code 用のネイティブグラフィカルインターフェースを提供し、IDE に直接統合されています。これは VS Code で Claude Code を使用する推奨方法です。
この拡張機能を使用すると、Claude のプランを受け入れる前に確認および編集でき、編集が行われるときに自動的に受け入れることができ、選択範囲から特定の行範囲を持つファイルを @-メンションでき、会話履歴にアクセスでき、複数の会話を別々のタブまたはウィンドウで開くことができます。
前提条件
インストール前に、以下があることを確認してください。
- VS Code 1.98.0 以上
- Anthropic アカウント：任意の有料 Claude サブスクリプション（Pro、Max、Team、または Enterprise）または Claude Console アカウントが機能し、API キーは不要です。拡張機能を初めて開くときに、このアカウントでサインインします。Amazon Bedrock や Google Cloud の Agent Platform などのサードパーティプロバイダーを通じて Claude にアクセスする場合は、セットアップ手順についてサードパーティプロバイダーを使用するを参照してください。
拡張機能をインストールする
IDE のリンクをクリックして直接インストールします。
または、VS Code で Cmd+Shift+X（Mac）または Ctrl+Shift+X（Windows/Linux）を押して拡張機能ビューを開き、「Claude Code」を検索して、インストールをクリックします。
拡張機能は Devin Desktop や Kiro などの他の VS Code フォークにもインストールされます。エディタの拡張機能ビューで「Claude Code」を検索するか、Open VSX レジストリからインストールしてください。エディタが拡張機能をインストールできない場合は、CLI をインストールして、統合ターミナルで claude を実行してください。CLI はどのターミナルでも動作します。
はじめに
インストール後、VS Code インターフェースを通じて Claude Code の使用を開始できます。
Claude Code パネルを開く
VS Code 全体で、Spark アイコンは Claude Code を示します。<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />
Claude を開く最速の方法は、エディタツールバー（エディタの右上隅）の Spark アイコンをクリックすることです。このアイコンは、ファイルを開いている場合にのみ表示されます。
Claude Code を開く他の方法：
- アクティビティバー：左サイドバーの Spark アイコンをクリックしてセッションリストを開きます。任意のセッションをクリックしてフルエディタタブとして開くか、新しいセッションを開始します。このアイコンは常にアクティビティバーに表示されます。
- コマンドパレット：
Cmd+Shift+P（Mac）またはCtrl+Shift+P（Windows/Linux）を押し、「Claude Code」と入力して、「Open in New Tab」などのオプションを選択します。 - ステータスバー：ウィンドウの右下隅の ✱ Claude Code をクリックします。ファイルを開いていない場合でも機能します。
Claude パネルをドラッグして、VS Code 内の任意の場所に再配置できます。詳細については、ワークフローをカスタマイズするを参照してください。
サインイン
パネルを初めて開くと、サインイン画面が表示されます。Sign in をクリックして、ブラウザで認可を完了します。
後で Not logged in · Please run /login が表示される場合、拡張機能はサインイン画面を自動的に再度開きます。表示されない場合は、コマンドパレットから Developer: Reload Window でウィンドウをリロードします。
シェルで ANTHROPIC_API_KEY が設定されているのにサインインプロンプトが表示される場合、VS Code がシェル環境を継承していない可能性があります。ターミナルから code . で VS Code を起動して環境変数を継承するか、代わりに Claude アカウントでサインインします。
サインイン後、Learn Claude Code チェックリストが表示されます。Show me をクリックして各項目を実行するか、X で閉じます。後で再度開くには、VS Code 設定の Extensions → Claude Code で Hide Onboarding をオフにします。
プロンプトを送信する
Claude にコードやファイルの支援を依頼します。これには、何かの仕組みを説明すること、問題をデバッグすること、または変更を加えることが含まれます。
ファイル内の特定の行について質問する例を次に示します。
変更を確認する
Claude がファイルを編集したい場合、元のコードと提案された変更の並べて比較を表示し、許可を求めます。編集を受け入れるか、拒否するか、Claude に別の方法を指示できます。受け入れる前に差分ビューで提案されたコンテンツを直接編集した場合、Claude はそれを変更したことが通知されるため、ファイルが元のプロポーザルと一致すると想定しません。
Claude Code でできることについてのアイデアについては、一般的なワークフローを参照してください。
プロンプトボックスを使用する
プロンプトボックスは複数の機能をサポートしています。
- 権限モード：プロンプトボックスの下部のモード指示器をクリックしてモードを切り替えるか、VS Code 設定の
claudeCode.initialPermissionModeでデフォルトを設定します。指示器が提供するすべてのモードについては、権限モードを参照してください。- Manual：Claude は各アクション前に許可を求めます。
- Plan：Claude は実行内容を説明し、変更を加える前に承認を待ちます。VS Code は自動的にプランをフル Markdown ドキュメントとして開き、Claude が開始する前にフィードバックを提供するためのインラインコメントを追加できます。
- Edit automatically：Claude は許可を求めずに編集を行います。
- コマンドメニュー：
/をクリックするか/と入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替え、プラン使用状況の表示（/usage）、および Remote Control セッションの開始（/remote-control）が含まれます。カスタマイズセクションは、MCP サーバー、hooks、メモリ、権限、プラグインへのアクセスを提供します。ターミナルアイコン付きのアイテムは統合ターミナルで開きます。- {/* min-version: 2.1.203 */}設定セクションには Enable Remote Control for all sessions が含まれており、これは
remoteControlAtStartupを設定して、すべての新しいインタラクティブセッションが Remote Control に自動的に接続されるようにします。Claude Code v2.1.203 以降が必要です。
- {/* min-version: 2.1.203 */}設定セクションには Enable Remote Control for all sessions が含まれており、これは
- コンテキスト指示器：プロンプトボックスは、Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクト化するか、
/compactを手動で実行できます。 - 拡張思考：Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー（
/）を使用してオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、Ctrl+Oを押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、拡張思考を参照してください。 - 複数行入力：
Shift+Enterを押して送信せずに新しい行を追加します。これは質問ダイアログの「その他」フリーテキスト入力でも機能します。
ファイルとフォルダを参照する
@-メンションを使用して、特定のファイルまたはフォルダに関するコンテキストを Claude に提供します。@ の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問したり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、部分的な名前を入力して必要なものを見つけることができます。
> Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
> What's in @src/components/ (include a trailing slash for folders)
大きな PDF の場合、Claude にファイル全体ではなく特定のページを読むよう依頼できます。単一ページ、1～10 ページなどの範囲、または 3 ページ以降などのオープンエンド範囲です。
エディタでテキストを選択すると、Claude は強調表示されたコードを自動的に表示できます。プロンプトボックスのフッターは、選択されている行数を表示します。Option+K（Mac）/ Alt+K（Windows/Linux）を押して、ファイルパスと行番号を含む @-メンション（例：@app.ts#5-10）を挿入します。選択指示器をクリックして、Claude が強調表示されたテキストを表示できるかどうかを切り替えます。目のスラッシュアイコンは、選択が Claude から隠されていることを意味します。
また、Shift を押しながらファイルをプロンプトボックスにドラッグして、添付ファイルとして追加することもできます。任意の添付ファイルの X をクリックしてコンテキストから削除します。
過去の会話を再開する
Claude Code パネルの上部の Session history ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間（今日、昨日、過去 7 日間など）で参照できます。任意の会話をクリックして、完全なメッセージ履歴で再開します。新しいセッションは、最初のメッセージに基づいて AI が生成したタイトルを受け取ります。セッションの上にマウスを置くと、名前変更と削除アクションが表示されます。説明的なタイトルを付けるために名前を変更するか、リストから削除するために削除します。セッションの再開の詳細については、セッションの管理を参照してください。
Claude.ai からリモートセッションを再開する
Web 上の Claude Code を使用している場合、VS Code でそれらのリモートセッションを直接再開できます。これには、Anthropic Console ではなく Claude.ai Subscription でサインインする必要があります。
セッション履歴を開く
Claude Code パネルの上部の Session history ボタンをクリックします。
Remote タブを選択する
ダイアログには 2 つのタブが表示されます。Local と Remote。Remote をクリックして claude.ai からのセッションを表示します。
再開するセッションを選択する
リモートセッションを参照または検索します。任意のセッションをクリックしてダウンロードし、会話をローカルで続行します。
アカウントと使用状況を確認する
コマンドメニューから /usage を実行して、アカウント＆使用状況ダイアログを開きます。サインインしているアカウント、プラン、および現在のセッションと週の使用状況バーが表示され、各制限がリセットされるまでの時間が示されます。
ダイアログは、プラン制限に寄与しているものを詳細に示します。キャッシュミス、長いコンテキスト、サブエージェント多用、または高度に並列化されたセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立て、それぞれを削減するためのヒントを提供します。属性テーブルは、各スキル、サブエージェント、プラグイン、MCP サーバーからどの程度の使用状況が発生したかを示します。Claude Code v2.1.174 以降が必要です。
Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。使用状況の追跡と削減の詳細については、コストを追跡するを参照してください。
ワークフローをカスタマイズする
起動して実行したら、Claude パネルを再配置したり、複数のセッションを実行したり、ターミナルモードに切り替えたりできます。
Claude が存在する場所を選択する
Claude パネルをドラッグして、VS Code 内の任意の場所に再配置できます。パネルのタブまたはタイトルバーをつかんでドラッグします。
- セカンダリサイドバー：ウィンドウの右側。コーディング中に Claude を表示したままにします。
- プライマリサイドバー：Explorer、Search などのアイコンが付いた左サイドバー。
- エディタ領域：Claude をファイルの横のタブとして開きます。サイドタスクに便利です。
複数の会話を実行する
コマンドパレットから Open in New Tab または Open in New Window を使用して、追加の会話を開始します。各会話は独自の履歴とコンテキストを保持し、異なるタスクで並行して作業できます。
タブを使用する場合、Spark アイコンの小さな色付きドットはステータスを示します。青は許可リクエストが保留中であることを意味し、オレンジはタブが非表示の間に Claude が完了したことを意味します。
ターミナルモードに切り替える
デフォルトでは、拡張機能はグラフィカルチャットパネルを開きます。CLI スタイルのインターフェースを使用する場合は、Use Terminal 設定を開いてボックスをチェックします。
VS Code 設定（Mac で Cmd+, または Windows/Linux で Ctrl+,）を開き、Extensions → Claude Code に移動して、Use Terminal をチェックすることもできます。
プラグインを管理する
VS Code 拡張機能には、プラグインをインストールおよび管理するためのグラフィカルインターフェースが含まれています。プロンプトボックスで /plugins と入力して、Manage plugins インターフェースを開きます。
プラグインをインストールする
プラグインダイアログには 2 つのタブが表示されます。Plugins と Marketplaces。
Plugins タブで：
- Installed plugins は上部に表示され、有効または無効にするためのトグルスイッチがあります。
- Available plugins は設定されたマーケットプレイスから下に表示されます。
- 名前または説明でプラグインをフィルタリングするために検索します。
- 利用可能なプラグインで Install をクリックします。
プラグインをインストールするときは、インストールスコープを選択します。
- Install for you：すべてのプロジェクトで利用可能（ユーザースコープ）
- Install for this project：プロジェクト協力者と共有（プロジェクトスコープ）
- Install locally：このリポジトリでのみ、あなたのためだけ（ローカルスコープ）
マーケットプレイスを管理する
Marketplaces タブに切り替えて、プラグインソースを追加または削除します。
- GitHub リポジトリ、URL、またはローカルパスを入力して新しいマーケットプレイスを追加します。
- 更新アイコンをクリックしてマーケットプレイスのプラグインリストを更新します。
- ゴミ箱アイコンをクリックしてマーケットプレイスを削除します。
変更を加えた後、バナーが表示され、Claude Code を再起動して更新を適用するよう促します。
プラグインシステムの詳細については、Plugins と Plugin marketplaces を参照してください。
Chrome でブラウザタスクを自動化する
Claude を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、VS Code を離れることなくブラウザワークフローを自動化します。これには、Claude in Chrome extension バージョン 1.0.36 以上が必要です。
プロンプトボックスで @browser と入力し、その後に Claude に実行させたいことを入力します。
@browser go to localhost:3000 and check the console for errors
添付メニューを開いて、新しいタブを開くやページコンテンツを読むなどの特定のブラウザツールを選択することもできます。
Claude はブラウザタスク用に新しいタブを開き、ブラウザのログイン状態を共有するため、既にサインインしているサイトにアクセスできます。
セットアップ手順、機能の完全なリスト、トラブルシューティングについては、Use Claude Code with Chrome を参照してください。
VS Code コマンドとショートカット
コマンドパレット（Mac で Cmd+Shift+P または Windows/Linux で Ctrl+Shift+P）を開き、「Claude Code」と入力して、Claude Code 拡張機能で利用可能なすべての VS Code コマンドを表示します。
一部のショートカットは、どのパネルが「フォーカス」されているか（キーボード入力を受け取っているか）によって異なります。カーソルがコードファイルにある場合、エディタはフォーカスされています。カーソルが Claude のプロンプトボックスにある場合、Claude はフォーカスされています。Cmd+Esc / Ctrl+Esc を使用してそれらを切り替えます。
| コマンド | ショートカット | 説明 |
|---|---|---|
| Focus Input | Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux） |
エディタと Claude 間のフォーカスを切り替える |
| Open in Side Bar | - | Claude を左サイドバーで開く |
| Open in Terminal | - | Claude をターミナルモードで開く |
| Open in New Tab | Cmd+Shift+Esc（Mac）/ Ctrl+Shift+Esc（Windows/Linux） |
新しい会話をエディタタブとして開く |
| Open in New Window | - | 新しい会話を別のウィンドウで開く |
| New Conversation | Cmd+N（Mac）/ Ctrl+N（Windows/Linux） |
新しい会話を開始します。Claude がフォーカスされている必要があり、enableNewConversationShortcut が true に設定されている必要があります。 |
| Reopen Closed Session | Cmd+Shift+T（Mac）/ Ctrl+Shift+T（Windows/Linux） |
最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、VS Code の通常の再度開く機能にフォールスルーします。enableReopenClosedSessionShortcut で無効にできます。 |
| Insert @-Mention Reference | Option+K（Mac）/ Alt+K（Windows/Linux） |
現在のファイルと選択への参照を挿入します（エディタがフォーカスされている必要があります） |
| Show Logs | - | 拡張機能デバッグログを表示します |
| Logout | - | Anthropic アカウントからサインアウトします |
他のツールから VS Code タブを起動する
拡張機能は vscode://anthropic.claude-code/open で URI ハンドラーを登録します。これを使用して、独自のツーリングから新しい Claude Code タブを開きます。シェルエイリアス、ブラウザブックマークレット、または URL を開くことができるスクリプトです。VS Code がまだ実行されていない場合、URL を開くと最初に起動します。VS Code が既に実行されている場合、URL は現在フォーカスされているウィンドウで開きます。
オペレーティングシステムの URL オープナーでハンドラーを呼び出します。
open "vscode://anthropic.claude-code/open"
xdg-open "vscode://anthropic.claude-code/open"
PowerShell で：
Start-Process "vscode://anthropic.claude-code/open"
cmd.exe では、start はその最初の引用符付き引数をウィンドウタイトルとして扱うため、URL の前に空のタイトルを渡します：
start "" "vscode://anthropic.claude-code/open"
ハンドラーは 2 つのオプションのクエリパラメーターを受け入れます：
| パラメーター | 説明 |
|---|---|
prompt |
プロンプトボックスに事前入力するテキスト。URL エンコードされている必要があります。プロンプトは事前入力されていますが、自動的には送信されません。 |
session |
新しい会話を開始する代わりに再開するセッション ID。セッションは、VS Code で現在開いているワークスペースに属している必要があります。セッションが見つからない場合、新しい会話が代わりに開始されます。セッションが既にタブで開いている場合、そのタブがフォーカスされます。セッション ID をプログラムで取得するには、Continue conversations を参照してください。 |
例えば、「review my changes」で事前入力されたタブを開くには：
vscode://anthropic.claude-code/open?prompt=review%20my%20changes
ターミナルセッションを VS Code タブの代わりに起動するには、CLI の claude-cli:// ハンドラーを使用します。Launch sessions from links を参照してください。
設定を構成する
拡張機能には 2 種類の設定があります。
- VS Code の拡張機能設定：VS Code 内の拡張機能の動作を制御します。
Cmd+,（Mac）またはCtrl+,（Windows/Linux）で開き、Extensions → Claude Code に移動します。/と入力して General Config を選択して設定を開くこともできます。 ~/.claude/settings.jsonの Claude Code 設定：拡張機能と CLI 間で共有されます。許可されたコマンド、環境変数、hooks、MCP サーバーに使用します。詳細については、Settings を参照してください。
拡張機能設定
| 設定 | デフォルト | 説明 |
|---|---|---|
useTerminal |
false |
グラフィカルパネルの代わりにターミナルモードで Claude を起動します。 |
initialPermissionMode |
default |
新しい会話の承認プロンプトを制御します。default、plan、acceptEdits、または bypassPermissions。{/* min-version: 2.1.200 */}manual は default のエイリアスであり、モード表示器で Manual というラベルが付いたモードを選択します。Claude Code v2.1.200 以降が必要です。permission modes を参照してください。 |
preferredLocation |
panel |
Claude が開く場所：sidebar（右）または panel（新しいタブ） |
autosave |
true |
Claude が読み取りまたは書き込みする前にファイルを自動保存します。 |
useCtrlEnterToSend |
false |
Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します。 |
enableNewConversationShortcut |
false |
Cmd/Ctrl+N を有効にして新しい会話を開始します。 |
enableReopenClosedSessionShortcut |
true |
Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、このショートカットは VS Code の通常の reopen-closed-editor コマンドを実行します。 |
hideOnboarding |
false |
オンボーディングチェックリスト（卒業キャップアイコン）を非表示にします。 |
respectGitIgnore |
true |
ファイル検索から .gitignore パターンを除外します。 |
usePythonEnvironment |
true |
Claude を実行するときにワークスペースの Python 環境をアクティベートします。Python 拡張機能が必要です。 |
environmentVariables |
[] |
Claude プロセスの環境変数を設定します。共有設定には Claude Code 設定を使用します。 |
disableLoginPrompt |
false |
認証プロンプトをスキップします（サードパーティプロバイダーセットアップ用）。 |
allowDangerouslySkipPermissions |
false |
モード選択ツールに Bypass permissions を追加します。インターネットアクセスのないサンドボックスでのみ使用してください。 |
claudeProcessWrapper |
- | Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスは、存在する場合は引数として渡されます。拡張機能ビルドにプラットフォーム用のバイナリが含まれていない場合は、これを別途インストールされた claude バイナリに設定します。 |
VS Code 拡張機能と Claude Code CLI
Claude Code は VS Code 拡張機能（グラフィカルパネル）と CLI（ターミナルのコマンドラインインターフェース）の両方として利用可能です。一部の機能は CLI でのみ利用可能です。CLI のみの機能が必要な場合は、VS Code の統合ターミナルで claude を実行します。これにはスタンドアロン CLI インストールが必要です。拡張機能は claude を PATH に追加しません。VS Code で CLI を実行するを参照してください。
| 機能 | CLI | VS Code 拡張機能 |
|---|---|---|
| コマンドと skills | すべて | サブセット（/ と入力して利用可能なものを表示） |
| MCP サーバー設定 | はい | 部分的（CLI 経由でサーバーを追加。チャットパネルで /mcp を使用して既存のサーバーを管理） |
| チェックポイント | はい | はい |
! bash ショートカット |
はい | いいえ |
| タブ補完 | はい | いいえ |
チェックポイントで巻き戻す
VS Code 拡張機能はチェックポイントをサポートしており、Claude のファイル編集を追跡し、以前の状態に巻き戻すことができます。任意のメッセージの上にマウスを置いて巻き戻しボタンを表示し、3 つのオプションから選択します。
- ここから会話をフォークする：このメッセージからの新しい会話ブランチを開始し、すべてのコード変更をそのまま保持します。
- ここにコードを巻き戻す：会話の完全な履歴を保持しながら、ファイル変更をこのポイントに戻します。
- 会話をフォークしてコードを巻き戻す：新しい会話ブランチを開始し、ファイル変更をこのポイントに戻します。
チェックポイントの仕組みと制限の詳細については、Checkpointing を参照してください。
VS Code で CLI を実行する
VS Code に留まりながら CLI を使用するには、統合ターミナル（Windows/Linux で Ctrl+` または Mac で Cmd+`）を開き、claude を実行します。CLI は自動的に IDE と統合され、差分表示や診断共有などの機能を提供します。
拡張機能をインストールしても、claude はシェルの PATH に追加されません。拡張機能はチャットパネル用に CLI のプライベートコピーをバンドルしていますが、ターミナルで claude と入力するにはスタンドアロン CLI インストールが必要です。インストールを 1 回実行すると、claude mcp add や claude --resume を含むこのページのコマンドが任意のターミナルで機能します。インストール後も claude が見つからない場合は、PATH を確認してください。
外部ターミナルを使用している場合は、Claude Code 内で /ide を実行して VS Code に接続します。
拡張機能と CLI を切り替える
拡張機能と CLI は同じ会話履歴を共有します。拡張機能の会話を CLI で続行するには、ターミナルで claude --resume を実行します。これにより、会話を検索して選択できるインタラクティブピッカーが開きます。
プロンプトにターミナル出力を含める
プロンプトで @terminal:name を使用してターミナル出力を参照します。ここで name はターミナルのタイトルです。これにより、Claude はコマンド出力、エラーメッセージ、またはログをコピーペーストせずに表示できます。
バックグラウンドプロセスを監視する
Claude が長時間実行されるコマンドを実行すると、拡張機能はステータスバーに進行状況を表示します。ただし、バックグラウンドタスクの可視性は CLI と比較して制限されています。より良い可視性のために、Claude にコマンドを出力させて、VS Code の統合ターミナルで実行できるようにします。
MCP で外部ツールに接続する
MCP（Model Context Protocol）サーバーは Claude に外部ツール、データベース、API へのアクセスを提供します。
MCP サーバーを追加するには、統合ターミナル（Ctrl+` または Cmd+`）を開き、claude mcp add を実行します。以下の例は GitHub のリモート MCP サーバーを追加します。このサーバーはヘッダーとして渡される個人用アクセストークンで認証します。
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
設定されたら、Claude にツールを使用するよう依頼します（例：「Review PR #456」）。
VS Code を離れることなく MCP サーバーを管理するには、チャットパネルで /mcp と入力します。MCP 管理ダイアログでは、サーバーを有効または無効にし、サーバーに再接続し、OAuth 認証を管理できます。利用可能なサーバーについては、MCP documentation を参照してください。
git で作業する
Claude Code は git と統合され、VS Code でバージョン管理ワークフローを直接支援します。Claude にコミット変更、プルリクエスト作成、またはブランチ間での作業を依頼します。
コミットとプルリクエストを作成する
Claude はコミットをステージング、コミットメッセージを作成、作業に基づいてプルリクエストを作成できます。
> commit my changes with a descriptive message
> create a pr for this feature
> summarize the changes I've made to the auth module
プルリクエストを作成するときに、Claude は実際のコード変更に基づいて説明を生成し、テストまたは実装の決定についてのコンテキストを追加できます。
並列タスク用に git worktrees を使用する
--worktree（-w）フラグを使用して、独自のファイルとブランチを持つ分離された worktree で Claude を開始します。
claude --worktree feature-auth
各 worktree は git 履歴を共有しながら独立したファイル状態を保持します。これにより、異なるタスクで作業するときに Claude インスタンスが互いに干渉するのを防ぎます。詳細については、Git worktrees で並列セッションを実行する を参照してください。
サードパーティプロバイダーを使用する
デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用して Claude にアクセスする場合は、代わりにプロバイダーを使用するように拡張機能を設定してください。
ログインプロンプトを無効にする
Disable Login Prompt 設定を開いてボックスをチェックします。
VS Code 設定（Mac で Cmd+, または Windows/Linux で Ctrl+,）を開き、'Claude Code login'を検索して、Disable Login Prompt をチェックすることもできます。
プロバイダーを設定する
プロバイダーのセットアップガイドに従います。
- Claude Code on Amazon Bedrock
- Claude Code on Google Cloud's Agent Platform
- Claude Code on Microsoft Foundry
これらのガイドは、~/.claude/settings.json でプロバイダーを設定することをカバーしており、VS Code 拡張機能と CLI 間で設定が共有されることを保証します。
セキュリティとプライバシー
コードはプライベートのままです。Claude Code はコード支援を提供するためにコードを処理しますが、モデルのトレーニングには使用しません。データ処理とログアウトの方法の詳細については、Data and privacy を参照してください。
自動編集権限が有効な場合、Claude Code は VS Code が自動的に実行する可能性がある VS Code 設定ファイル（settings.json や tasks.json など）を変更できます。信頼できないコードで作業するときのリスクを軽減するには、以下を実行してください。
- 信頼できないワークスペースに対して VS Code Restricted Mode を有効にします
- 編集の自動受け入れの代わりに手動承認モードを使用します
- 変更を受け入れる前に慎重に確認します
組み込み IDE MCP サーバー
拡張機能がアクティブな場合、CLI が自動的に接続するローカル MCP サーバーを実行します。これは、CLI が VS Code のネイティブ差分ビューアで差分を開く方法、@-メンション用に現在の選択を読む方法、および Jupyter ノートブックで作業しているときに VS Code にセルを実行するよう依頼する方法です。
サーバーは ide という名前で、設定するものがないため /mcp から非表示になっています。ただし、組織が PreToolUse hook を使用して MCP ツールをホワイトリストに登録している場合は、それが存在することを知る必要があります。
選択とオープンファイルコンテキスト。 接続中、CLI は現在のエディタ選択とアクティブなファイルのパスを各プロンプトのコンテキストとして含めます。トランスクリプトは、これが発生したときに ⧉ Selected N lines from <file> 行を表示します。.env などの機密ファイルを除外するには、そのパスに対して Read deny rule を追加します。一致する deny rule は、そのファイルの選択されたテキストとオープンファイル通知の両方が Claude に到達するのを防ぎます。
トランスポートと認証。 サーバーは 127.0.0.1 にバインドし、ランダムな高いポートで、他のマシンからはアクセスできません。各拡張機能のアクティベーションは、接続するために CLI が提示する必要がある新しいランダム認証トークンを生成します。トークンは ~/.claude/ide/ の下のロックファイルに書き込まれ、0600 権限を持つ 0700 ディレクトリにあるため、VS Code を実行しているユーザーのみがそれを読むことができます。
モデルに公開されるツール。 サーバーは約 12 個のツールをホストしていますが、モデルに表示されるのは 2 つだけです。残りは、CLI が独自の UI（差分を開く、選択を読む、ファイルを保存する）に使用する内部 RPC であり、ツールリストが Claude に到達する前にフィルタリングされます。
| ツール名（hooks で見られるとおり） | 実行内容 | 書き込み？ |
|---|---|---|
mcp__ide__getDiagnostics |
言語サーバー診断を返します。VS Code の問題パネルのエラーと警告。オプションで 1 つのファイルにスコープされます。 | いいえ |
mcp__ide__executeCode |
アクティブな Jupyter ノートブックのカーネルで Python コードを実行します。以下の確認フローを参照してください。 | はい |
Jupyter 実行は常に最初に尋ねます。 mcp__ide__executeCode は何も静かに実行できません。各呼び出しで、コードはアクティブなノートブックの最後に新しいセルとして挿入され、VS Code はそれをビューにスクロールし、ネイティブ Quick Pick は Execute または Cancel を尋ねます。キャンセル（または Esc でピッカーを閉じる）は Claude にエラーを返し、何も実行されません。ツールはまた、アクティブなノートブックがない場合、Jupyter 拡張機能（ms-toolsai.jupyter）がインストールされていない場合、またはカーネルが Python でない場合に完全に拒否します。
一般的な問題を修正する
拡張機能がインストールされない
- VS Code の互換バージョン（1.98.0 以上）があることを確認してください
- VS Code に拡張機能をインストールする権限があることを確認してください
- VS Code Marketplace から直接インストールしてみてください
Spark アイコンが表示されない
Spark アイコンは、ファイルを開いている場合、エディタツールバー（エディタの右上）に表示されます。表示されない場合：
- ファイルを開く：アイコンはファイルを開く必要があります。フォルダを開いているだけでは不十分です。
- VS Code バージョンを確認：1.98.0 以上が必要です（Help → About）
- VS Code を再起動：コマンドパレットから「Developer: Reload Window」を実行してください
- 競合する拡張機能を無効にする：他の AI 拡張機能（Cline、Continue など）を一時的に無効にしてください
- ワークスペーストラストを確認：拡張機能は制限モードでは機能しません
または、ステータスバー（右下隅）の「✱ Claude Code」をクリックしてください。これはファイルを開かなくても機能します。コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を使用して「Claude Code」と入力することもできます。
macOS で Cmd+Esc が機能しない
macOS Tahoe 以降では、システムのゲームオーバーレイショートカットがデフォルトで Cmd+Esc にバインドされており、キープレスが VS Code に到達する前に傍受されます。ショートカットを解放するには：
- システム設定を開く
- キーボード、次にキーボードショートカット、次にゲームコントローラーに移動します
- ゲームオーバーレイチェックボックスをクリアします
または、拡張機能を別のキーに再バインドしてください：VS Code の キーボードショートカットエディタ（Cmd+K Cmd+S）を開き、Claude Code: Focus input を検索して、新しいバインディングを割り当ててください。
Claude Code が応答しない
Claude Code がプロンプトに応答しない場合：
- インターネット接続を確認：安定したインターネット接続があることを確認してください
- 新しい会話を開始：新しい会話を開始して、問題が続くかどうかを確認してください
- CLI を試す：ターミナルから
claudeを実行して、より詳細なエラーメッセージが表示されるかどうかを確認してください
問題が続く場合は、エラーの詳細を含めて GitHub で問題を報告してください。
拡張機能をアンインストールする
Claude Code 拡張機能をアンインストールするには：
- 拡張機能ビューを開きます（Mac で
Cmd+Shift+Xまたは Windows/Linux でCtrl+Shift+X） - 「Claude Code」を検索します
- Uninstall をクリックします
VS Code 統合ターミナルで claude を実行すると、拡張機能が自動的に再インストールされます。拡張機能をインストールされたままにしないようにするには、/config で Auto-install IDE extension をオフにするか、autoInstallIdeExtension を false に設定します。また、CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 環境変数を 1 に設定することもできます。
拡張機能データを削除してすべての設定をリセットするには、プラットフォーム用の拡張機能のストレージディレクトリを削除します。
macOS の場合：
rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code
Linux の場合：
rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code
Windows の場合（PowerShell）：
Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"
追加のヘルプについては、トラブルシューティングガイドを参照してください。
次のステップ
VS Code で Claude Code をセットアップしたので：
- 一般的なワークフローを探索して Claude Code を最大限に活用します。
- MCP サーバーをセットアップして、外部ツールで Claude の機能を拡張します。CLI を使用してサーバーを追加し、チャットパネルで
/mcpを使用して管理します。 - Claude Code 設定を構成して、許可されたコマンド、hooks などをカスタマイズします。これらの設定は拡張機能と CLI 間で共有されます。