SpyBara
Go Premium

vs-code.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

This page contains 121 additions and 58 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

VS Code で Claude Code を使用する

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

VS Code エディタの右側に Claude Code 拡張機能パネルが開いており、Claude との会話が表示されている

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 で 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 アイコンをクリックすることです。このアイコンはファイルを開いている場合にのみ表示されます。

VS Code エディタでエディタツールバーに表示された 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 に支援を求めます。これは、何かの仕組みを説明すること、問題をデバッグすること、または変更を加えることなど、様々なことが含まれます。

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

VS Code エディタで Python ファイルの 2～3 行が選択されており、Claude Code パネルに @-mention 参照を含むそれらの行についての質問が表示されている
4

変更を確認する

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

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

提案された編集を 1 つずつ確認するには、diff 内の各変更の下にある Accept this change および Reject this change ボタンを使用します。変更を拒否すると、提案されたコンテンツ内でそれが元に戻されます。受け入れると、確認済みとしてマークされます。ファイル全体を受け入れるか拒否すると、確認が完了します。100 を超える変更を含む diff は、変更ごとのボタンなしで開かれるため、ファイル全体として確認してください。変更ごとの確認には Claude Code v2.1.275 以降が必要です。

同じアクションは、エディタのコンテキストメニューおよびコマンドパレットから Claude Code: Accept Change at Cursor および Claude Code: Reject Change at Cursor として利用できます。

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

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

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

  • 権限モード: プロンプトボックスの下部にあるモード表示をクリックして、権限モードを切り替えます。Pro、Max、Team プランでは、Auto が組み込みの開始権限モードです。拡張機能が開始権限モードを選択する方法と、表示されるすべての権限モードについては、こちらをご覧ください。

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

  • Model: コマンドメニューから Switch model… を選択して、セッション中にモデルを変更します。プロンプトボックスの下部にあるモデル名をクリックして、同じピッカーを開くこともできます。

    現在のモデルが努力レベルをサポートしている場合、ピッカーは Effort 行も表示し、モデル名ボタンは選択されたレベルを表示します。max 以外のレベルを選択すると、Claude Code はそれを現在のモデルのデフォルトとしてユーザー設定の modelSettings に保存します。max は現在のセッションにのみ適用されます。モデル名ボタンと Effort 行には Claude Code v2.1.257 以降が必要です。

  • コマンドメニュー: / をクリックするか / を入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替えが含まれます。

    Customize セクションは、MCP サーバー、コマンド、出力スタイル、hooks、メモリ、instructions、権限、プラグインへのアクセスを提供します。ターミナルアイコンが付いているアイテムは統合ターミナルで開きます。

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

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

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

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

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

    • Customize セクションで Memory を選択して、自動メモリをオンまたはオフにします。オンの場合、Claude が保存したメモリを参照し、それらを保存するフォルダをファイルマネージャーで表示することもできます。Claude Code v2.1.274 以降が必要です。

      保存されたメモリをクリックしてダイアログで読み取り、テキストを編集したり、メモリを削除したり、そのファイルをエディターで開いたりできます。ダイアログでメモリを表示、編集、削除するには Claude Code v2.1.275 以降が必要です。

    • Customize セクションで Instructions を選択して、Claude が読むCLAUDE.md ファイルを編集します。ファイルを選択してエディターで開きます。ファイルがまだ存在しない場合、Claude Code は最初にそれを作成します。Claude Code v2.1.274 以降が必要です。

    • 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 の最新のやることリストは表示されたままになり、Claude からの保留中の質問が尋ねているテキストも表示されたままになります。これには Claude Code v2.1.225 以降が必要です。Claude がサブエージェントを実行している間、最新のアクティビティを含むライブ進捗行が、それらを開始したツール呼び出しグループの下に表示されます。これには Claude Code v2.1.269 以降が必要です。

    • Anthropic アカウントからサインアウトするには、Settings セクションで Sign out を選択するか、/logout を入力します。サードパーティプロバイダーでは、メニューはどちらも提供しません。Claude Code v2.1.277 以降が必要です。

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

      組織のポリシーが製品フィードバックをオフにしている場合、Report a problem はメニューに表示されず、/bug と /feedback はレポートを開く代わりに Feedback is turned off by your organization's policy or this environment's settings. という通知を表示します。

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

  • 応答をコピー: 応答にマウスを置いて Copy response をクリックしてクリップボードにコピーするか、/copy を入力して最新の応答をコピーします。/copy 2 は 2 番目に新しい応答をコピーします。Claude Code v2.1.277 以降が必要です。

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

  • プロンプトキャッシュクロック: コンテキスト表示の横にある時計アイコンは、会話のプロンプトキャッシュが期限切れになるまでの時間を推定します。キャッシュの 5 分または 1 時間の有効期限からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、キャッシュを無効にするアクションはクロックをリセットしないため、モデルを切り替えた後も残り時間を表示できます。

    • カウントダウンが終了するまで、アイコンは 12m などの残り時間を表示します。
    • カウントダウンが終了すると、分が消え、アイコンは赤くなるか、次の応答までテーマのエラーカラーになります。キャッシュは期限切れの可能性があるため、次のメッセージへの応答が遅くなり、キャッシュが再構築される間、より高くなることを予想してください。5 分の有効期限がメッセージ間で実行され続ける場合は、TTL を自分で選択を参照してください。
    • 会話がコンパクト化された直後、アイコンは次の応答までの分なしで赤くなります。キャッシュはまだコンパクト化された会話をカバーしていないためです。

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

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

    マップは、バックグラウンドシェルコマンドやモニターなどのセッションの他のバックグラウンドタスクもエージェントの下に一覧表示します。行をクリックしてタスクのカードを開き、そこで停止します。

    エージェント数が表示されていない場合（Claude がバックグラウンドシェルを開始したがサブエージェントがない場合など）にマップを開くには、プロンプトボックスで /tasks を入力します。マップ内のバックグラウンドタスクと入力された /tasks には Claude Code v2.1.277 以降が必要です。

  • 拡張思考: 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）を挿入します。選択表示の X をクリックして削除し、Claude が選択を受け取らないようにします。他のテキストを選択すると、表示が戻ります。

拡張機能は一部のファイルから選択されたテキストを保留します。ファイルがワークスペース内にあり、files.exclude または search.exclude 設定と一致する場合、Claude は最大でもファイルのパスを受け取り、選択したテキストは受け取りません。同じことが git が無視するファイルにも適用されます。ただし、VS Code の search.useIgnoreFiles 設定と拡張機能の respectGitIgnore 設定の両方がオンになっている場合に限ります。これはデフォルトです。このフィルターはチャットパネルのみをカバーします。Claude Code が統合ターミナルで実行される場合、CLI はファイルに関係なく選択されたテキストを送信するため、Read 拒否ルールを追加して、ファイルのコンテンツが Claude にそこに到達しないようにします。

Claude はエディターで開いているファイルも表示します。何も選択されていない場合でも、プロンプトボックスはその名前を表示します。選択されたテキストのみを追加するには、Attach Open File 設定をオフにします。この設定には Claude Code v2.1.271 以降が必要です。

メッセージに画像とファイルを添付することもできます。

  • 画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。
  • ファイルを添付するには、Shift を押しながらプロンプトボックスにドラッグします。
  • コンテキストから添付ファイルを削除するには、その X をクリックします。

過去の会話を再開する

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

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

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

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

アーカイブされたセッションを復元するには、Archived sessions を展開して Unarchive session をクリックします。アーカイブされたすべてのセッションを一度に復元するには、セッションリストの Activity Bar で Archived sessions ヘッダーにマウスを置き、その復元アイコンをクリックします。これには Claude Code v2.1.277 以降が必要です。v2.1.257 より前では、アクションは Delete session でした。これはセッションを非表示にし、復元する方法がありませんでした。その後削除したセッションは、アップグレード後に Archived sessions の下に表示されます。

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

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

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

クラウドセッションを実行している場合、VS Code で直接再開できます。これには Claude.ai Subscription でのサインインが必要です。Anthropic Console ではありません。

1

セッション履歴を開く

Claude Code パネルの上部にある Session history ボタンをクリックします。

2

Web タブを選択

ダイアログには 2 つのタブが表示されます。Local と Web です。Web をクリックして claude.ai からのセッションを表示します。

3

再開するセッションを選択

クラウドセッションを参照または検索します。任意のセッションをクリックしてダウンロードし、会話をローカルで続行します。

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

/usage を実行して Account & usage ダイアログを開きます。サインインしているアカウントを表示し、報告される使用状況はサインインによって異なります。

  • claude.ai プラン: 現在のセッションと週など、プランの制限の使用状況バー。各バーは、制限がリセットされるまでの時間を表示します。

    ダイアログは、プランの制限に寄与しているものも詳しく説明します。キャッシュミス、長いコンテキスト、サブエージェント集約型または高度に並列化されたセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立て、それぞれを削減するためのヒントを提供します。属性テーブルは、各スキル、サブエージェント、プラグイン、MCP サーバーからどの程度の使用状況が来たかを示します。

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

  • その他のサインイン: サードパーティプロバイダーまたは API キーなど、プランの制限がサインインに適用されない場合、Usage セクションはセッション自体のコストとトークン使用状況を代わりに表示します。CLI の /usage はセッションブロックで同じ合計を表示します。Activity Bar のセッションリストは、Account & usage ヘッダーの下にアクティブセッションの合計も表示します。Claude Code v2.1.277 以降が必要です。

使用状況の追跡と削減の詳細については、コストを追跡を参照してください。

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

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

Claude の配置場所を選択する

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

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

Claude がエディタグループの新しいタブを開くと、拡張機能はそのグループをロックするため、Claude タブがフォーカスされている間に開いたファイルは別のグループに移動します。

拡張機能がグループをロックするのを停止するには、Lock Editor Groups 設定をオフにします。既にロックされているグループは、ロック解除するまでロックされたままです。この設定には Claude Code v2.1.274 以降が必要です。

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

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

リロードが Claude の途中のステップを中断した場合、会話が戻ると Claude はそのステップを続行し、チャット内の通知が継続をマークします。Claude Code v2.1.274 以降が必要です。ステップが 1 時間以上前に中断されたか、セッションが別の場所で開かれている場合、会話はアイドル状態で戻ります。

継続をオフにするには、Continue After Reload 設定を開いてチェックを外します。

複数の会話を実行する

コマンドパレットから 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 つのクエリパラメータを受け取ります。

パラメータ 説明
plugin マーケットプレイスにリストされているプラグインの名前。必須です。
marketplace プラグインの出所：GitHub の owner/repo、https:// URL、または git@github.com:owner/repo.git などの git SSH URL。省略した場合は anthropics/claude-plugins-official がデフォルトになります。

マーケットプレイスタブが受け入れるいくつかの値（ローカルパスや http:// アドレスなど）はリンクでは機能しません。これらの場合、VS Code はエラーメッセージを表示し、ダイアログは開きません。

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 を使用して、それらを切り替えます。

コマンド ショートカット 説明
Focus Input Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux） エディターと Claude 間のフォーカスを切り替えます
Focus last message - 会話内の最新メッセージ、または待機中の権限プロンプトにキーボードフォーカスを移動します。キーボードまたはスクリーンリーダーでそこから読み取ることができます。ターミナルモードでは利用できません。Claude Code v2.1.268 以降が必要です
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） 現在のファイルと選択範囲への参照を挿入します（エディターがフォーカスされている必要があります）
Accept Change at Cursor - 提案された編集をレビューする際に、カーソル位置の変更を 1 つずつ受け入れます。Claude Code v2.1.275 以降が必要です
Reject Change at Cursor - 提案された編集をレビューする際に、カーソル位置の変更を 1 つずつ元に戻します。Claude Code v2.1.275 以降が必要です
Toggle Focus view Ctrl+Option+F（Mac）/ Ctrl+Alt+F（Windows/Linux） 会話内のツールアクティビティを非表示にするか表示します。Claude パネルまたはサイドバーが表示されている間に機能します。Claude Code v2.1.221 以降が必要です
Rename Session Tab - アクティブな Claude タブのセッションの名前を変更します。Claude Code v2.1.257 以降が必要です
Add Session Tab to Group - アクティブな Claude タブのセッションを、選択または作成するセッショングループに追加します。Claude Code v2.1.257 以降が必要です
Mark Session as Unread - アクティブな Claude タブのセッションをセッションリストで未読としてマークします。Claude Code v2.1.257 以降が必要です
Show Logs - 拡張機能のデバッグログを表示します
Logout - Anthropic アカウントからサインアウトします

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

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

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

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

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

パラメーター 説明
prompt プロンプトボックスに事前入力するテキスト。URL エンコードされている必要があります。プロンプトは事前入力されますが、自動的には送信されません。
session 新しい会話を開始する代わりに再開するセッション ID。セッションは、VS Code で現在開いているワークスペースに属している必要があります。セッションが見つからない場合は、代わりに新しい会話が開始されます。セッションが既にタブで開いている場合、そのタブがフォーカスされます。セッション ID をプログラムで取得するには、会話を続ける を参照してください。

たとえば、「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 に設定し、ワークスペース値を適用していました。

設定 デフォルト 説明
useTerminal false Claude をグラフィカルパネルではなくターミナルモードで起動します
initialPermissionMode - 新しい会話の承認プロンプトを制御します：default、plan、acceptEdits、または bypassPermissions。manual は default のエイリアスで、モード指示器で Manual というラベルが付いたモードを選択します。設定を未設定のままにすると、拡張機能は Switch permission modes で説明されているように開始権限モードを選択します。
preferredLocation panel Claude が開く場所：sidebar（右）または panel（新しいタブ）
lockEditorGroups true Claude がそのタブを開始するエディターグループをロックして、Claude タブがフォーカスされている間に開いたファイルが別のグループに移動するようにします。オフの場合、拡張機能はエディターグループをロックしません。Claude Code v2.1.274 以降が必要です
autosave true Claude がファイルを読み取りまたは書き込みする前に自動保存します
attachOpenFile true エディターで開いているファイルをメッセージに追加し、プロンプトボックスに表示します。オフの場合、選択したテキストのみが追加されます。Claude Code v2.1.271 以降が必要です
useCtrlEnterToSend false Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します
scrollToBottomOnSend true メッセージを送信するときに会話を下部にスクロールします。オフの場合、会話は元の位置に留まります。Claude Code v2.1.275 以降が必要です
enableNewConversationShortcut false Cmd/Ctrl+N を有効にして新しい会話を開始します
enableReopenClosedSessionShortcut true Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、ショートカットは VS Code の通常の再度開く閉じたエディターコマンドを実行します。
archiveInactiveSessions 14 この日数アクティビティがない場合、セッションを自動的にアーカイブします：1、2、7、または 14。0 に設定してオフにします。Claude Code v2.1.265 以降が必要です
continueAfterReload true ウィンドウをリロードした後、Claude は復元されたセッションで 中断されたステップを続行します。Claude Code v2.1.274 以降が必要です
hideOnboarding false オンボーディングチェックリスト（卒業帽アイコン）を非表示にします
focusView false ツール呼び出し、ツール結果、思考を展開可能な行の背後に非表示にして、プロンプトと Claude の応答を残します。Claude の最新のやることリストは表示されたままです。これには Claude Code v2.1.225 以降が必要です。コマンドメニューから Focus ビューを切り替えることもできます。Claude Code v2.1.221 以降が必要です
respectGitIgnore true ファイル検索と 選択コンテキスト から .gitignore パターンを除外します
usePythonEnvironment true Claude を実行するときにワークスペースの Python 環境をアクティブにします。Python 拡張機能が必要です。
environmentVariables [] Claude プロセスの環境変数を設定します。共有構成には Claude Code 設定を使用してください。
disableLoginPrompt false 認証プロンプトをスキップします（サードパーティプロバイダーのセットアップ用）
allowDangerouslySkipPermissions false モードセレクターに権限をバイパスを追加します。インターネットアクセスのないサンドボックスでのみ使用してください。
claudeProcessWrapper - Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスが存在する場合、引数として渡されます。プラットフォーム用のバイナリが拡張機能ビルドに含まれていない場合は、別途インストールされた claude バイナリに設定します。ラップされたセットアップでは、initialPermissionMode を設定するか、以前の会話で Manual、Edit automatically、または Auto を選択していない限り、会話は Manual モードで開始されます。これは、拡張機能が設定とビルトインデフォルトステップをスキップするためです。Switch permission modes を参照してください。アクティベーション時の「Unsupported platform」エラーは、プラットフォーム用にバイナリがバンドルされていないことを意味します。npm install 後にネイティブバイナリが見つからない を参照してください。

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

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

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

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

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

Claude が作業している間、スクリーンリーダーはプログレススピナーのアニメーションの代わりにテキストラベルを読みます。

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

キーボードからチャットパネルを使用する

トランスクリプト内の各ターンは、ターンを開始したプロンプトでラベル付けされた視覚的に隠されたヘッディングで始まるため、スクリーンリーダーのヘッディングナビゲーションを使用してターン間をジャンプできます。

ターン内で、スクリーンリーダーはメッセージを移動するときに、誰のメッセージであるかを通知します。

  • あなたのメッセージ: 「You」
  • Claude のメッセージ: 「Claude」
  • ツールステップ: 「Claude」とツール名（「Claude, Bash」など）
  • 思考ブロック: 「Claude, thinking」

拡張機能はトランスクリプトをラベル付きリージョンとして公開しているため、Tab でトランスクリプト自体にフォーカスを移動して、自分のペースで読むこともできます。最新のメッセージまたは待機中の権限プロンプトにフォーカスを移動するには、代わりに コマンドパレット から Claude Code: Focus last message を実行します。

権限プロンプトのオプションが権限ルールまたはディレクトリアクセスを保存する場合、そのラベルは「すべてのプロジェクト」や「このセッション」など、承認が保存される場所を名前で指定して終了します。そのオプションにフォーカスがある場合、Left または Right 矢印キーを押して保存先を変更でき、拡張機能は移動するたびに各保存先を通知します。ラベル内の保存先をクリックすることもできます。矢印キーには Claude Code v2.1.268 以降が必要です。

VS Code 拡張機能と Claude Code CLI

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

機能 CLI VS Code 拡張機能
コマンドとスキル すべて サブセット（/ を入力して利用可能なものを表示）
MCP サーバー設定 はい はい（チャットパネルで /mcp を使用してサーバーを追加・管理）
チェックポイント はい はい
! Bash ショートカット はい いいえ
タブ補完 はい いいえ

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

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 はコマンド出力、エラーメッセージ、またはログをコピー＆ペーストなしで確認できます。

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

プロンプトボックスで /tasks を入力してエージェントマップを開きます。これにより、セッションのバックグラウンドタスク（Claude がバックグラウンドシェルコマンドとして実行中の開発サーバーなど）が一覧表示されます。タスクをクリックしてそのカードを開き、そこで停止できます。Claude Code v2.1.277 以降が必要です。

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 にアクセスしている場合は、代わりにプロバイダーを使用するように拡張機能を設定してください。

1

ログインプロンプトを無効化する

ログインプロンプトを無効化する設定を開き、チェックボックスをオンにします。

VS Code の設定（Mac では Cmd+,、Windows/Linux では Ctrl+,）を開き、「Claude Code login」を検索して、ログインプロンプトを無効化するをオンにすることもできます。

2

プロバイダーを設定する

プロバイダーのセットアップガイドに従ってください。

これらのガイドでは、~/.claude/settings.json でプロバイダーを設定する方法について説明しており、VS Code 拡張機能と CLI の間で設定が共有されることを保証します。

サードパーティプロバイダーでは、拡張機能は claude.ai アカウントが必要な機能（プラン使用状況バー、音声入力、クラウドセッション用の Web タブなど）を提供しません。これらのサインインで Account & usage ダイアログが表示する内容については、アカウントと使用状況を確認するを参照してください。以前の /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 に到達するのを防ぎます。

Attach Open File 設定をオフにすると、CLI はテキストを選択している間のみアクティブファイルのパスを受け取ります。

トランスポートと認証。 サーバーは 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 に到達する前にフィルタリングされます。

ツール名（フックで表示される） 機能 読み取り専用
mcp__ide__getDiagnostics 言語サーバー診断（VS Code の Problems パネルのエラーと警告）を返します。オプションで 1 つのファイルにスコープできます。 はい
mcp__ide__executeCode アクティブな Jupyter ノートブックのカーネルで Python コードを実行します。以下の確認フローを参照してください。 いいえ

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

一般的な問題を解決する

拡張機能がインストールできない

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 で設定したら、以下を実行してください。