VS Code で Claude Code を使用する

Claude Code 拡張機能を VS Code にインストールして設定します。インラインの差分表示、@-メンション、プラン確認、キーボードショートカットを使用した AI コーディング支援を取得します。

VS Code 拡張機能は、Claude Code 用のネイティブグラフィカルインターフェースを提供し、IDE に直接統合されています。これは VS Code で Claude Code を使用する推奨方法です。

この拡張機能を使用すると、Claude のプランを受け入れる前に確認および編集でき、編集が行われるときに自動的に受け入れることができ、選択範囲から特定の行範囲を持つファイルを @-メンションでき、会話履歴にアクセスでき、複数の会話を別々のタブまたはウィンドウで開くことができます。

前提条件

インストール前に、以下があることを確認してください。

• VS Code 1.94.0 以上
• Anthropic アカウント：任意の有料 Claude サブスクリプション（Pro、Max、Team、または Enterprise）または Claude Console アカウントが機能し、API キーは不要です。拡張機能を初めて開くときに、このアカウントでサインインします。Amazon Bedrock や Google Cloud の Agent Platform などのサードパーティプロバイダーを通じて Claude にアクセスする場合は、セットアップ手順についてサードパーティプロバイダーを使用するを参照してください。

拡張機能をインストールする

IDE のリンクをクリックして直接インストールします。

• VS Code 用にインストール
• Cursor 用にインストール

または、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 の使用を開始できます。

1

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」などのオプションを選択します。
• ステータスバー：preferredLocation を sidebar に設定した場合、または Claude Code: Open in Side Bar で Claude を開いた場合、ウィンドウの右下隅の ✻ Claude Code をクリックします。ファイルが開いていない場合でも機能します。

Claude パネルをドラッグして VS Code 内の任意の場所に移動できます。詳細はワークフローをカスタマイズするを参照してください。

2

サインイン

パネルを初めて開くと、サインイン画面が表示されます。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 をオフにします。

3

プロンプトを送信する

コードやファイルについて Claude に支援を求めます。これは、何かの仕組みを説明すること、問題をデバッグすること、または変更を加えることなど、様々なことが含まれます。

ファイル内の特定の行について質問する例を以下に示します。

4

変更を確認する

表示内容は、プロンプトボックスの下部に表示される権限モードによって異なります。

• Auto または Edit automatically モードでは、Claude はワークスペース内のほとんどのファイルを確認なしで編集します。
• Manual モードでは、Claude がファイルを編集したい場合、元のコンテンツと提案された変更の並べて比較を表示し、権限を求めます。受け入れたり、拒否したり、代わりに Claude に何をするかを指示したりできます。受け入れる前に diff ビューで提案されたコンテンツを直接編集した場合、Claude はそれを修正したことが通知されるため、ファイルが元の提案と一致していると想定されません。

Claude Code でできることについてのアイデアについては、一般的なワークフローを参照してください。

プロンプトボックスを使用する

プロンプトボックスは複数の機能をサポートしています。

• 権限モード: プロンプトボックスの下部にあるモード指示器をクリックして、権限モードを切り替えます。Pro、Max、Team プランでは、Auto がビルトイン開始権限モードです。拡張機能が開始権限モードを選択する方法と、指示器が提供するすべての権限モードについては、こちらを参照してください。

  • Auto: 分類器があなたに尋ねる代わりにほとんどのアクションをレビューします。auto モードで、それがレビューおよびブロックする内容を確認してください。
  • Manual: Claude はファイル編集とほとんどのシェルコマンドの前に権限を求めます。
  • Plan: Claude は実行する内容を説明し、変更を加える前に承認を待ちます。VS Code は自動的にプランを完全な Markdown ドキュメントとして開き、Claude が開始する前にフィードバックを提供するためにインラインコメントを追加できます。
  • Edit automatically: Claude は尋ねることなく編集を行います。

• Model: コマンドメニューから Switch model… を選択して、セッション中にモデルを変更します。プロンプトボックスの下部にあるモデル名をクリックして、同じピッカーを開くこともできます。現在のモデルが effort levels をサポートしている場合、ピッカーは Effort 行も表示します。モデル名ボタンと Effort 行には Claude Code v2.1.257 以降が必要です。

• Command menu: / をクリックするか / を入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替えが含まれます。Customize セクションは MCP サーバー、slash commands、出力スタイル、hooks、メモリ、権限、プラグインへのアクセスを提供します。ターミナルアイコン付きのアイテムは統合ターミナルで開きます。

  • /usage や /remote-control などのコマンドを参照するには、Customize セクションで Slash commands を選択します。ダイアログはフィルターボックス付きでそれらをリストします。1 つを選択して実行します。プロンプトボックスで / を入力すると、引き続きコマンドをインラインで提案します。Claude Code v2.1.257 以降が必要です。

  • Customize セクションで Output styles を選択して、カスタムスタイルを含む output style を選択します。Claude Code v2.1.257 以降が必要です。

    代わりにカスタムスタイルを作成するには、Output styles メニューから Build a custom style を選択します。Claude Code はプロジェクトまたはユーザーレベルで style file を作成します。Claude Code v2.1.261 以降が必要です。

  • Customize セクションで Hooks を選択して、セッションに読み込まれた hooks をイベント別にグループ化して表示します。ユーザー、プロジェクト、ローカル設定ファイルに保存された hooks を追加、編集、削除できます。マネージド設定やプラグインなどの他のソースからの Hooks は読み取り専用です。Claude Code v2.1.269 以降が必要です。

  • Customize セクションで Permissions を選択して、セッションの permission rules を Allow、Ask、Deny にグループ化して表示します。ユーザー、プロジェクト、ローカル設定にルールを追加し、そこに保存されたルールを削除できます。マネージド設定やこのセッションのみに対して行われた承認などの他のソースからのルールは読み取り専用です。Claude Code v2.1.269 以降が必要です。

  • Settings セクションには Enable Remote Control for all sessions が含まれており、これは remoteControlAtStartup を設定して、新しいインタラクティブセッションが Remote Control に自動的に接続するかどうかを制御します。Claude Code v2.1.203 以降が必要です。

    VS Code ウィンドウでトグルをオンまたはオフにすると、その変更は、その後に開始するセッションだけでなく、その VS Code ウィンドウで既に開いているセッションに適用されます。オフにすると、開いているセッションは切断されます。Claude Code v2.1.261 以降では、その変更は他の VS Code ウィンドウで開いているセッションにも到達します。

  • Settings セクションには Focus view も含まれており、これはツール呼び出し、ツール結果、思考を展開可能な行の背後に隠し、プロンプトと Claude の応答を残します。そこでトグルするか、Ctrl+Option+F（Mac）/ Ctrl+Alt+F（Windows/Linux）で、またはコマンドパレットから Claude Code: Toggle Focus view で切り替えます。変更はすべての開いているセッションに適用され、セッション全体で保持されます。Claude Code v2.1.221 以降が必要です。

    Claude の最新の to-do リストは表示されたままで、Claude からの保留中の質問が尋ねているテキストも表示されます。これには Claude Code v2.1.225 以降が必要です。Claude が subagents を実行している間、最新のアクティビティを含むライブ進捗行は、それらを開始したツール呼び出しグループの下に表示されます。これには Claude Code v2.1.269 以降が必要です。

  • バグを報告するには、メニューの下部にある Report a problem をクリックするか、/bug または /feedback をオプションの説明と共に入力して、レポートに事前入力します。レポートを送信し、ファーストパーティ接続で Anthropic にサインインしている場合、Claude Code はそれを Anthropic に送信します。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、ダイアログは引き続き開きますが、送信するとエラーが表示され、何も送信されません。CLI の /bug とは異なり、拡張機能はローカルアーカイブを作成しません。Claude Code v2.1.229 以降が必要です。

• Side questions: /btw の後に質問を入力して、会話に追加せずにセッションについて質問します。答えはチャットの横のパネルで開き、そこでフォローアップ質問をすることができます。スレッドはウィンドウの再読み込みを生き残ります。Claude Code は最新の 20 回の交換を保持し、Claude Code が 安全に保持期間を決定できる限り、cleanupPeriodDays スケジュールで保存されたスレッドを期限切れにします。スレッドをクリアするには、パネルのゴミ箱アイコンをクリックします。Claude Code v2.1.227 以降が必要です。

• Context indicator: プロンプトボックスは Claude のコンテキストウィンドウをどのくらい使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、/compact を手動で実行できます。

• Agent map: 会話に subagents が含まれている場合、プロンプトボックスの下部に 2 agents などのエージェント数が表示されます。そのドットは、subagent が動作しているか、あなたの権限を待っているかを示します。

  エージェント数をクリックしてエージェントマップを開きます。これは会話の subagents をメインエージェントの下のツリーとして描画し、各エージェントのステータス、経過時間、トークン数を表示します。subagent をクリックして、そのプロンプトとツール呼び出しを表示し、読み取り専用トランスクリプトを開くか、実行中に停止します。Claude Code v2.1.269 以降が必要です。

• Extended thinking: Claude が複雑な問題を推論するのに時間をかけることができます。コマンドメニュー（/）経由でオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、Ctrl+O を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、Extended thinking を参照してください。

• Multi-line input: Shift+Enter を押して、送信せずに新しい行を追加します。これは質問ダイアログの「Other」フリーテキスト入力でも機能します。

ファイルとフォルダを参照する

@-mentions を使用して、特定のファイルまたはフォルダについて 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）を押して、ファイルパスと行番号を含む @-mention を挿入します（例：@app.ts#5-10）。選択指示器の X をクリックして、Claude が選択を受け取らないようにします。別のテキストを選択するか、別のファイルに切り替えると、指示器が戻ります。

画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。また、Shift を押しながらファイルをプロンプトボックスにドラッグして、添付ファイルとして追加することもできます。任意の添付ファイルの X をクリックして、コンテキストから削除します。

過去の会話を再開する

Claude Code パネルの上部にある Session history ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。

任意の会話をクリックして、完全なメッセージ履歴で再開します。セッションが現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。セッションの再開の詳細については、Manage sessions を参照してください。

• Session titles: 新しいセッションは、最初のメッセージに基づいて AI が生成したタイトルを受け取ります。
• Rename and archive: セッションの上にマウスを置くと、これらのアクションが表示されます。説明的なタイトルを付けるために名前変更するか、リストの下部にある Archived sessions グループに移動するためにアーカイブします。

デフォルトでは、14 日間アクティビティがないセッションは、開いている、未読、または group にない限り、自動的に Archived sessions に移動します。自動アーカイブには Claude Code v2.1.265 以降が必要です。期間を変更するか、オフにするには、Archive Inactive Sessions setting を開き、日数を選択するか Never を選択します。

アーカイブされたセッションを復元するには、Archived sessions を展開して Unarchive session をクリックします。v2.1.257 より前では、アクションは Delete session でした。これはセッションを隠し、復元する方法がありませんでした。その後削除したセッションは、アップグレード後に Archived sessions の下に表示されます。

再開した会話が plan モードで終了した場合、Claude Code は plan モードを復元します。Claude Code v2.1.246 以降が必要です。Claude Code は 2 つのケースでは復元しません。

• 拡張機能が claudeCode.initialPermissionMode から 開始権限モードを選択するか、以前の会話から引き継がれるピックがある
• claudeCode.claudeProcessWrapper が設定されている

Claude.ai からクラウドセッションを再開する

Claude Code on the web を使用している場合、それらのクラウドセッションを VS Code で直接再開できます。これには Anthropic Console ではなく、Claude.ai Subscription でサインインする必要があります。

アカウントと使用状況を確認する

/usage を実行して、Account & usage ダイアログを開きます。ダイアログは claude.ai サインインが必要なため、サードパーティプロバイダーでは提供されません。サインインしたアカウント、プラン、現在のセッションと週の使用状況バーを表示します。各バーは、制限がリセットされるまでの時間を表示します。

ダイアログは、プラン制限に貢献しているものを詳細に説明します。キャッシュミス、長いコンテキスト、subagent が多い、または高度に並列なセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立てます。各動作には、それを削減するためのヒントが付いています。Attribution テーブルは、各スキル、subagent、プラグイン、MCP サーバーからどのくらいの使用状況が来たかを示します。

Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。使用状況の追跡と削減の詳細については、Track your costs を参照してください。

ワークフローをカスタマイズする

Claude パネルの位置を変更したり、複数の会話を実行したり、セッションリストをグループに整理したり、ターミナルモードに切り替えたりできます。

Claude の配置場所を選択する

Claude パネルを VS Code 内の任意の場所に移動できます。パネルのタブまたはタイトルバーをつかんで、以下の場所にドラッグします。

• セカンダリサイドバー: ウィンドウの右側。コード作成中に Claude を表示したままにします。
• プライマリサイドバー: Explorer、Search などのアイコンがある左側のサイドバー。
• エディタ領域: Claude をファイルの横のタブとして開きます。サイドタスクに便利です。

Developer: Reload Window を実行するか VS Code を再起動した後、チャットがその会話とともに戻るかどうかは、それがどこで開かれていたかによって異なります。

• エディタタブ: 会話はそのタブとともに戻ります。
• サイドバー: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、セッション履歴から会話を再開してください。

複数の会話を実行する

コマンドパレットから Open in New Tab または Open in New Window を使用して、追加の会話を開始します。各会話は独自の履歴とコンテキストを保持し、異なるタスクを並行して処理できます。

タブを使用する場合、スパークアイコンの小さなカラーの点がステータスを示します。青は権限リクエストが保留中であることを意味し、オレンジはタブが非表示の間に Claude が完了したことを意味します。

セッションをグループに整理する

アクティビティバーのセッションリストで、関連するセッションを名前付きの折りたたみ可能なグループに集めることができます。Claude Code v2.1.229 以降が必要です。

• セッションをグループ化または非グループ化する: セッションを右クリックしてそれからグループを作成したり、既存のグループに移動したり、グループから削除したりします。各セッションは一度に 1 つのグループに属するため、別のグループに移動すると最初のグループから削除されます。
• 複数のセッションを一度に移動する: Cmd キー（Mac）/ Ctrl キー（Windows/Linux）を押しながら各セッションをクリックするか、Shift キーを押しながらクリックして範囲を選択してから、選択内容を右クリックします。
• タブからセッションをグループ化する: コマンドパレットから Claude Code: Add Session Tab to Group を実行してからグループを選択または作成します。Claude Code v2.1.257 以降が必要です。
• グループの名前を変更または削除する: グループヘッダーを右クリックします。グループを削除するとグループのみが削除され、そのセッションは非グループ化されたリストに戻ります。

拡張機能はワークスペースフォルダごとにグループを保存するため、ウィンドウの再読み込み後も保持され、同じフォルダを開くすべてのウィンドウに表示されます。リストを検索すると、拡張機能はすべてのグループ全体で 1 つのフラットリストに一致するものを表示します。

ターミナルモードに切り替える

デフォルトでは、拡張機能はグラフィカルチャットパネルを開きます。CLI スタイルのインターフェースを使用する場合は、Use Terminal 設定を開いてチェックボックスをオンにします。

VS Code 設定（Mac では Cmd+,、Windows/Linux では Ctrl+,）を開き、Extensions → Claude Code に移動して、Use Terminal をチェックすることもできます。

プラグインを管理する

VS Code 拡張機能には、プラグインをインストールおよび管理するためのグラフィカルインターフェイスが含まれています。プロンプトボックスに /plugins と入力して、プラグインを管理インターフェイスを開きます。

プラグインをインストールする

プラグインダイアログには、プラグインとマーケットプレイスの 2 つのタブが表示されます。

プラグインタブでは、以下のことができます。

• インストール済みプラグインがトップに表示され、トグルスイッチで有効または無効にできます
• 設定されたマーケットプレイスからの利用可能なプラグインが下に表示されます
• 名前または説明でプラグインをフィルタリングするために検索します
• 利用可能なプラグインのインストールをクリックします

プラグインをインストールするときは、インストールスコープを選択します。

• あなたのためにインストール：すべてのプロジェクトで利用可能（ユーザースコープ）
• このプロジェクトのためにインストール：プロジェクト協力者と共有（プロジェクトスコープ）
• ローカルにインストール：このリポジトリのみ、あなただけ（ローカルスコープ）

プラグインインストールリンクを共有する

特定のプラグインのインストールに直接誘導するリンクを送信するには、拡張機能の install-plugin URL を使用します。これを開くと VS Code が起動またはフォーカスされ、Claude Code パネルが開き、プラグインを管理ダイアログがそのプラグインのスコープ選択で開きます。ユーザーがスコープを選択するまで、何もインストールされません。プラグインのマーケットプレイスが Claude Code でまだ設定されていない場合、ダイアログはまずそれを追加するよう求めます。

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

URL は 2 つのクエリパラメータを受け取ります。

2 つのケースでは、スコープ選択ではなくダイアログのメッセージで終了します。

• マーケットプレイスにその名前のプラグインがリストされていない：ダイアログはプラグインが見つからなかったことを報告します。plugin の値をマーケットプレイスのリストと照合してください。
• プラグインが既にインストールされている：ダイアログはそのことを示し、何も変わりません。

GitHub README、issue、およびその他の Markdown ホストの一部は、スキームが http または https ではないリンクを削除するため、vscode:// リンクはプレーンテキストとしてレンダリングされます。これらのホストではコードブロック内に URL を配置してください。リンクがクリック可能ではなくプレーンテキストとしてレンダリングされるは claude-cli:// リンクについて説明しています。

マーケットプレイスを管理する

マーケットプレイスタブに切り替えて、プラグインソースを追加または削除します。

• GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します
• 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します
• ゴミ箱アイコンをクリックして、マーケットプレイスを削除します

ダイアログで加えたプラグイン変更は、その VS Code ウィンドウで開いている Claude Code セッションにすぐに適用されます。ダイアログを開いたセッションがプラグインをリロードできない場合、ダイアログは再度試すか、そのセッションで Claude を再起動するオプションを提供します。

プラグインシステムの詳細については、プラグインおよびプラグインマーケットプレイスを参照してください。

Chrome でブラウザタスクを自動化する

Claude を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、VS Code を離れることなくブラウザワークフローを自動化できます。これには Claude in Chrome 拡張機能 バージョン 1.0.36 以上が必要です。

プロンプトボックスに @browser と入力し、その後に Claude に実行させたい内容を入力します。

@browser go to localhost:3000 and check the console for errors

添付メニューを開いて、新しいタブを開く、ページコンテンツを読むなど、特定のブラウザツールを選択することもできます。

Claude はブラウザタスク用に新しいタブを開き、ブラウザのログイン状態を共有するため、既にサインインしているサイトにアクセスできます。

セットアップ手順、機能の完全なリスト、トラブルシューティングについては、Claude Code を Chrome で使用する を参照してください。

VS Code コマンドとショートカット

コマンドパレット（Mac では Cmd+Shift+P、Windows/Linux では Ctrl+Shift+P）を開いて「Claude Code」と入力すると、Claude Code 拡張機能で利用可能なすべての VS Code コマンドが表示されます。

一部のショートカットは、どのパネルが「フォーカス」されているか（キーボード入力を受け取っているか）によって異なります。カーソルがコードファイル内にある場合、エディターがフォーカスされています。カーソルが Claude のプロンプトボックス内にある場合、Claude がフォーカスされています。Cmd+Esc / Ctrl+Esc を使用して、それらを切り替えます。

他のツールから VS Code タブを起動する

拡張機能は vscode://anthropic.claude-code/open で URI ハンドラーを登録します。これを使用して、独自のツール（シェルエイリアス、ブラウザーブックマークレット、または URL を開くことができるスクリプト）から新しい Claude Code タブを開きます。VS Code がまだ実行されていない場合、URL を開くと最初に起動します。VS Code が既に実行されている場合、URL は現在フォーカスされているウィンドウで開きます。

オペレーティングシステムの URL オープナーでハンドラーを呼び出します。

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

ハンドラーは 2 つのオプションのクエリパラメーターを受け入れます：

たとえば、「review my changes」で事前入力されたタブを開くには：

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

拡張機能はまた vscode://anthropic.claude-code/install-plugin を処理します。これは1 つのプラグインでプラグインダイアログを開きます。VS Code タブの代わりにターミナルセッションを起動するには、CLI の claude-cli:// ハンドラーを使用します。リンクからセッションを起動する を参照してください。

設定を構成する

拡張機能には 2 つのタイプの設定があります。

• VS Code の拡張機能設定：VS Code 内での拡張機能の動作を制御します。Cmd+,（Mac）または Ctrl+,（Windows/Linux）で開き、Extensions → Claude Code に移動します。/ を入力して General config… を選択して設定を開くこともできます。
• ~/.claude/settings.json の Claude Code 設定：拡張機能と CLI 間で共有されます。許可されたコマンド、環境変数、hooks、MCP サーバーに使用します。Pro、Max、Team プランでは、権限モード会話が開始される入力の 1 つでもあります。Switch permission modes に順序が記載されています。詳細は Settings を参照してください。

拡張機能設定

VS Code は initialPermissionMode をユーザー設定から読み込み、ワークスペース値を無視します。v2.1.225 より前では、VS Code は設定をデフォルトの default に設定し、ワークスペース値を適用していました。

スクリーンリーダーを使用する

拡張機能のチャットパネルはスクリーンリーダーに対応しています。何も設定する必要はありません。拡張機能はすべてのユーザーの会話アクティビティを通知し、視覚的な変化はありません。これは CLI のオプトイン スクリーンリーダーモード とは別のもので、ターミナルインターフェースを適応させます。

チャットパネルのスクリーンリーダーサポートには Claude Code v2.1.236 以降が必要です。

会話中、拡張機能は以下を通知します。

• Claude の返信: 拡張機能は各返信が完了したときに 1 回通知し、テキストがストリーミングされている間は沈黙を保ちます。スクリーンリーダーはコードブロックを行数の概要として読み、リンクをラベルで読み、テーブルをセルごとに読みます。完全な返信はトランスクリプトで読み取り可能なままです。
• 権限リクエストと質問: 拡張機能は権限プロンプトが表示されたときにリクエストを通知し、Claude が使用したいツールの名前を指定します。Claude があなたに質問するときと Claude がプランを完了してあなたのレビューを待つときも同じ方法で通知します。
• ステータス変更: 拡張機能は Claude が作業を開始したとき、Claude があなたの入力の準備ができたとき、および Claude Code が会話をコンパクト化し始めたときを通知します。
• エラーとモデルプロンプト: 拡張機能は会話内のエラーを通知し、使用クレジット同意プロンプト または フラグ付きリクエストプロンプト が表示されたときを通知します。

トランスクリプト内の各ターンは、ターンを開始したプロンプトでラベル付けされた視覚的に隠されたヘッディングで始まるため、スクリーンリーダーのヘッディングナビゲーションを使用してターン間をジャンプできます。Tab でトランスクリプト自体にフォーカスを移動することもできます。拡張機能はそれをラベル付きリージョンとして公開しており、自分のペースで読むことができます。Claude が作業している間、スクリーンリーダーはプログレススピナーのアニメーションの代わりにテキストラベルを読みます。

セッションを再度開くか別のセッションに切り替えると、拡張機能は何も通知しません。復元された履歴、保留中の権限プロンプト、および進行中のステータスは、新しいことが発生するまで沈黙を保ちます。

VS Code 拡張機能と Claude Code CLI

Claude Code は VS Code 拡張機能（グラフィカルパネル）と CLI（ターミナルのコマンドラインインターフェース）の両方で利用できます。一部の機能は CLI でのみ利用可能です。CLI のみの機能が必要な場合は、VS Code の統合ターミナルで claude を実行してください。これにはスタンドアロン CLI インストールが必要です。拡張機能は claude を PATH に追加しません。VS Code で CLI を実行するを参照してください。

チェックポイントでの巻き戻し

VS Code 拡張機能はチェックポイントをサポートしており、Claude のファイル編集を追跡し、以前の状態に巻き戻すことができます。任意のメッセージにマウスを置くと巻き戻しボタンが表示されます。その後、3 つのオプションから選択します。

• ここから会話をフォークする：このメッセージからの新しい会話ブランチを開始し、すべてのコード変更はそのまま保持します
• ここまでコードを巻き戻す：会話履歴全体を保持しながら、ファイル変更をこのポイントまで戻します
• 会話をフォークしてコードを巻き戻す：新しい会話ブランチを開始し、ファイル変更をこのポイントまで戻します

チェックポイントの仕組みと制限事項の詳細については、チェックポイントを参照してください。

VS Code で CLI を実行する

VS Code に留まりながら CLI を使用するには、統合ターミナルを開き（Windows/Linux では Ctrl+`、Mac では Cmd+`）、claude を実行します。CLI は diff 表示と診断共有などの機能のために 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 はコマンド出力、エラーメッセージ、またはログをコピー＆ペーストなしで確認できます。

バックグラウンドプロセスを監視する

拡張機能でのバックグラウンドタスクの可視性は CLI と比較して限定的です。より良い可視性を得るには、Claude にコマンドを出力させて、VS Code の統合ターミナルで実行します。

MCP を使用して外部ツールに接続する

MCP（Model Context Protocol）サーバーは Claude に外部ツール、データベース、API へのアクセスを提供します。

VS Code を離れずに MCP サーバーを管理するには、チャットパネルで /mcp を入力します。開いたダイアログから、サーバーを追加したり、ローカル、ユーザー、またはプロジェクトスコープに保存されたサーバーを削除したり、サーバーを有効または無効にしたり、サーバーに再接続したり、OAuth 認証を管理したりできます。ダイアログでサーバーを追加・削除するには Claude Code v2.1.261 以降が必要です。

VS Code の統合ターミナル（Ctrl+` または Cmd+`）で claude mcp add を実行することもできます。ダイアログとターミナルコマンドは同じ MCP 設定に保存され、どちらからの変更も、その後に開始する会話に反映されます。以下の例は GitHub のリモート MCP サーバーを追加します。このサーバーは、ヘッダーとして渡される個人用アクセストークンで認証します。

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

YOUR_GITHUB_PAT を個人用アクセストークンに置き換えます。claude mcp add コマンドは認証情報を検証せずに設定を保存するため、ここではプレースホルダー値が受け入れられますが、サーバーは後で接続に失敗します。接続を確認するには、新しい会話を開始し、/mcp を入力して、サーバーが接続済みと表示されていることを確認します。認証情報が不正なサーバーは失敗と表示されます。

設定後、Claude にツールを使用するよう依頼します（例：「PR #456 をレビューしてください」）。

接続するサーバーを見つけるには、MCP サーバーを検索・構築するを参照してください。

git で作業する

Claude Code は git と統合されており、VS Code 内で直接バージョン管理ワークフローをサポートします。Claude にコミット、プルリクエストの作成、またはブランチ間での作業を依頼できます。独立した worktree とそれ自身のファイルおよびブランチで Claude を開始するには、worktrees を使用した並列セッションの実行を参照してください。

コミットとプルリクエストを作成する

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 は実際のコード変更に基づいて説明を生成し、テストまたは実装の決定に関するコンテキストを追加できます。

サードパーティプロバイダーを使用する

デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用して Claude にアクセスしている場合は、代わりにプロバイダーを使用するように拡張機能を設定してください。

サードパーティプロバイダーでは、拡張機能は claude.ai アカウントが必要な機能（使用状況の追跡、音声入力、クラウドセッション用の Web タブなど）を提供しません。以前の /login から残された claude.ai サインインは未使用のままです。拡張機能はリクエストと共にそれを送信しません。

セキュリティとプライバシー

あなたのコードはプライベートです。Claude Code はあなたのコードを処理して支援を提供しますが、モデルの訓練に使用することはありません。データ処理の詳細とログ記録をオプトアウトする方法については、データとプライバシーを参照してください。

自動編集権限が有効になっている場合、Claude Code は VS Code が自動的に実行する可能性のある VS Code 設定ファイル（settings.json や tasks.json など）を変更できます。信頼できないコードを操作する場合のリスクを軽減するには、以下の対策を講じてください。

• 信頼できないワークスペースに対して VS Code Restricted Mode を有効にする
• 自動編集または自動の代わりに Manual モードを使用する
• 変更を受け入れる前に慎重に確認する

組み込み IDE MCP サーバー

拡張機能がアクティブな場合、CLI が自動的に接続するローカル MCP サーバーが実行されます。これにより、CLI は VS Code のネイティブ diff ビューアーで diff を開き、@ メンションの現在の選択を読み取り、Jupyter ノートブックで作業している場合はセルを実行するよう VS Code に要求できます。

サーバーは ide という名前で、設定するものがないため /mcp から非表示になっています。ただし、組織が MCP ツールをホワイトリストに登録するために PreToolUse フックを使用している場合は、それが存在することを知っておく必要があります。

選択とオープンファイルコンテキスト。 接続中、CLI は現在のエディター選択とアクティブファイルのパスを、送信する各プロンプトのコンテキストとして含めます。トランスクリプトには、これが発生したときに ⧉ Selected N lines from <file> という行が表示されます。.env などの機密ファイルを除外するには、そのパスに対して Read 拒否ルールを追加してください。一致する拒否ルールは、そのファイルの選択されたテキストとオープンファイル通知の両方が Claude に到達するのを防ぎます。

トランスポートと認証。 サーバーは 127.0.0.1 の 10000～65535 の範囲内のランダムポートにバインドされ、ポートは設定できません。トランスポートは暗号化されていない ws:// です。ソケットはループバックのみであるため、トラフィックをキャプチャできるプロセスはロックファイルからトークンを読み取ることもできるため、TLS は保護を追加しません。各拡張機能のアクティベーションは新しいランダム認証トークンを生成し、~/.claude/ide/<port>.lock のロックファイルに書き込み、CLI は X-Claude-Code-Ide-Authorization ヘッダーとして提示して接続する必要があります。ロックファイルは 0700 ディレクトリ内で 0600 権限を持つため、VS Code を実行しているユーザーのみがそれを読み取ることができます。CLAUDE_CONFIG_DIR が設定されている場合、ロックファイルは代わりに $CLAUDE_CONFIG_DIR/ide/ に書き込まれます。

モデルに公開されるツール。 サーバーは 12 個のツールをホストしていますが、モデルに表示されるのは 2 つだけです。残りは CLI が独自の UI（diff を開く、選択を読み取る、ファイルを保存する）に使用する内部 RPC であり、ツールリストが Claude に到達する前にフィルタリングされます。

Jupyter 実行は常に最初に確認します。 mcp__ide__executeCode は何もサイレントに実行することはできません。各呼び出しで、コードはアクティブなノートブックの最後に新しいセルとして挿入され、VS Code がそれをビューにスクロールし、ネイティブ Quick Pick が Execute または Cancel を求めます。キャンセルするか、Esc でピッカーを閉じると、Claude にエラーが返され、何も実行されません。また、アクティブなノートブックがない場合、Jupyter 拡張機能（ms-toolsai.jupyter）がインストールされていない場合、またはカーネルが Python でない場合、ツールは完全に拒否します。

• VS Code の互換性のあるバージョン（1.94.0 以降）があることを確認してください
• VS Code に拡張機能をインストールする権限があることを確認してください
• VS Code Marketplace から直接インストールしてみてください

Spark アイコンが表示されない

Spark アイコンは、ファイルを開いているときに Editor Toolbar（エディタの右上）に表示されます。表示されない場合は、以下の手順を実行してください。

1. ファイルを開く：アイコンを表示するにはファイルを開く必要があります。フォルダを開いているだけでは不十分です。
2. VS Code のバージョンを確認する：1.94.0 以降が必要です（Help → About）
3. VS Code を再起動する：コマンドパレットから「Developer: Reload Window」を実行してください
4. 競合する拡張機能を無効にする：他の AI 拡張機能（Cline、Continue など）を一時的に無効にしてください
5. ワークスペースの信頼を確認する：拡張機能は制限モードでは動作しません

または、preferredLocation を sidebar に設定している場合、または Claude Code: Open in Side Bar で Claude を開いている場合は、Status Bar（右下隅）の「✻ Claude Code」をクリックしてください。これはファイルを開いていなくても動作します。Command Palette（Cmd+Shift+P / Ctrl+Shift+P）を使用して「Claude Code」と入力することもできます。

macOS で Cmd+Esc が機能しない

macOS Tahoe 以降では、システムの Game Overlay ショートカットがデフォルトで Cmd+Esc にバインドされており、VS Code に到達する前にキープレスをインターセプトします。ショートカットを解放するには、以下の手順を実行してください。

1. System Settings を開く
2. Keyboard、Keyboard Shortcuts、Game Controllers の順に移動する
3. Game Overlay チェックボックスをクリアする

または、拡張機能を別のキーにリバインドしてください。VS Code の Keyboard Shortcuts editor（Cmd+K Cmd+S）を開き、Claude Code: Focus input を検索して、新しいバインディングを割り当ててください。

Claude Code が応答しない

Claude Code がプロンプトに応答しない場合は、以下の手順を実行してください。

1. インターネット接続を確認する：安定したインターネット接続があることを確認してください
2. 新しい会話を開始する：新しい会話を開始して、問題が解決するかどうかを確認してください
3. CLI を試す：ターミナルから claude を実行して、より詳細なエラーメッセージが表示されるかどうかを確認してください

問題が解決しない場合は、GitHub で issue を報告してください。エラーの詳細を含めてください。

拡張機能をアンインストールする

Claude Code 拡張機能をアンインストールするには：

1. 拡張機能ビューを開きます（Mac では Cmd+Shift+X、Windows/Linux では Ctrl+Shift+X）
2. 「Claude Code」を検索します
3. アンインストール をクリックします

VS Code の統合ターミナルで claude を実行すると、Claude Code は拡張機能を自動的に再インストールします。拡張機能をインストールされたままにしないようにするには、/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"

詳細なヘルプについては、トラブルシューティングガイド を参照してください。

次のステップ

Claude Code を VS Code で設定したら、以下を実行してください。

• 一般的なワークフローを確認することで、Claude Code を最大限に活用できます
• MCP サーバーを設定することで、外部ツールを使用して Claude の機能を拡張できます。チャットパネルで /mcp を使用して、これらを追加および管理できます。
• Claude Code の設定を構成することで、許可されたコマンド、hooks などをカスタマイズできます。これらの設定は、拡張機能と CLI 間で共有されます。