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 にアクセスする場合は、セットアップ手順についてサードパーティプロバイダーを使用するを参照してください。

​

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

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

• その他の VS Code フォーク：拡張機能は Devin Desktop や Kiro などのフォークにもインストールできます。エディタの拡張機能ビューで「Claude Code」を検索するか、Open VSX レジストリからインストールしてください。
• 拡張機能をインストールできないエディタ：代わりに CLI をインストールし、エディタの統合ターミナルで claude を実行してください。CLI はどのターミナルでも動作します。
• 開発コンテナ：開発コンテナ内で Claude Code を実行するには、開発コンテナを参照してください。

​

はじめに

1

Claude Code パネルを開く

VS Code 全体を通して、Spark アイコンは Claude Code を表します: 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 内の任意の場所に移動できます。詳しくはワークフローをカスタマイズするを参照してください。

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 に依頼しましょう。

Claude は選択したテキストを自動的に認識します。Option+K（Mac）/ Alt+K（Windows/Linux）を押すと、@メンション参照（@file.ts#5-10 など）をプロンプトに挿入することもできます。

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

4

変更を確認する

プロンプトボックスの下部に表示されている権限モードを確認してください。

• Auto または Edit automatically モードでは、Claude はワークスペース内のほとんどのファイルを確認なしで編集します。
• Manual モードでは、Claude がファイルを編集しようとすると、元の内容と提案された変更を並べて比較表示し、権限を求めます。承認、拒否、または代わりに何をすべきかを Claude に伝えることができます。承認する前に差分ビューで提案内容を直接編集した場合は、変更したことが Claude に伝えられるため、Claude はファイルが元の提案と一致しているとは想定しません。

提案された編集を 1 つの変更ずつ確認するには、差分内の各変更の下にある Accept this change ボタンと Reject this change ボタンを使用します。変更を拒否すると提案内容からその変更が元に戻され、承認するとその変更は確認済みとしてマークされます。変更ごとの確認には Claude Code v2.1.275 以降が必要です。ファイル全体を承認または拒否しても、引き続き確認を完了できます。100 を超える変更を含む差分は変更ごとのボタンなしで開かれるため、ファイル全体として確認してください。同じ操作は、エディターのコンテキストメニューからカーソル位置で、またコマンドパレットから Claude Code: Accept Change at Cursor および Claude Code: Reject Change at Cursor として実行することもできます。

​

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

• 権限モード: プロンプトボックス下部のモードインジケーターをクリックすると、権限モードを切り替えられます。Claude Code v2.1.283 以降では Auto が組み込みの開始時の権限モードです。それより前のバージョンでは、Pro、Max、Team プランでのみ Auto が開始時の権限モードになります。何によって変わるか、およびインジケーターで選択できるすべての権限モードについては、拡張機能が開始時の権限モードを選択する仕組みを参照してください。
  • Auto: ユーザーに確認する代わりに、分類器がほとんどのアクションをレビューします。レビューおよびブロックされる内容については、auto モードを参照してください。
  • Manual: Claude はファイルの編集やほとんどのシェルコマンドの前に権限を求めます。
  • Plan: Claude は実行する内容を説明し、変更を加える前に承認を待ちます。VS Code はプランを完全な Markdown ドキュメントとして自動的に開き、Claude が作業を始める前にインラインコメントを追加してフィードバックを伝えられます。 プロンプトボックスに /plan と入力することもできます。Claude Code v2.1.280 以降が必要です。
    • /plan: plan モードに切り替えます。すでに plan モードの場合は、現在のプランを表示します。
    • /plan fix the auth bug のようにタスクを付けた /plan: plan モードに切り替え、そのタスクの計画を開始します。
    • /plan open: すでに plan モードの場合、エディターでプランファイルを開きます。
  • Edit automatically: Claude は確認せずに編集を行います。
• モデル: コマンドメニューから Switch model… を選択すると、セッションの途中でモデルを変更できます。プロンプトボックス下部のモデル名をクリックしても、同じピッカーを開けます。Claude Code v2.1.284 以降では、プロンプトボックスに /model のみを入力してもピッカーが開きます。 現在のモデルが effort レベルをサポートしている場合、ピッカーには Effort 行も表示され、モデル名ボタンには選択したレベルが表示されます。max 以外のレベルを選択すると、Claude Code はそれを現在のモデルのデフォルトとして、ユーザー設定の modelSettings に保存します。max は現在のセッションにのみ適用されます。モデル名ボタンと Effort 行には Claude Code v2.1.257 以降が必要です。 動的ワークフローが有効で、現在のモデルがそれをサポートしている場合、Effort 行の下に Ultracode スイッチが表示されます。これをオンにすると、Claude はこのセッションの実質的なタスクごとに、選択した effort レベルでワークフローを計画します。オンの間、モデル名ボタンにはレベルの後に · Ultracode と表示されます。このスイッチには Claude Code v2.1.284 以降が必要です。
• コマンドメニュー: / をクリックするか / と入力すると、コマンドメニューが開きます。ファイルの添付、モデルの切り替え、拡張思考の切り替えなどのオプションがあります。 Customize セクションには、MCP サーバー、コマンド、出力スタイル、フック、メモリ、指示、権限、プラグインなどの項目があります。ターミナルアイコンの付いた項目は統合ターミナルで開きます。
  • /usage や /remote-control などのコマンドを一覧するには、Customize セクションで Slash commands を選択します。フィルターボックス付きのダイアログにコマンドが一覧表示されます。いずれかを選ぶと実行されます。プロンプトボックスに / と入力した場合も、引き続きインラインでコマンドが候補表示されます。Claude Code v2.1.257 以降が必要です。 /skills と入力してもこのダイアログが開きます。各スキルの行には、On や Name only などの表示設定が表示されます。表示設定をクリックすると変更できます。ただし、プラグインのスキルなど locked と表示された行は変更できません。/skills ショートカットと表示設定のコントロールには Claude Code v2.1.280 以降が必要です。
  • Customize セクションで Output styles を選択すると、カスタムスタイルを含む出力スタイルを選択できます。Claude Code v2.1.257 以降が必要です。 代わりにカスタムスタイルを作成するには、Output styles メニューから Build a custom style を選択します。Claude Code がプロジェクトレベルまたはユーザーレベルでスタイルファイルを作成します。Claude Code v2.1.261 以降が必要です。
  • Customize セクションで 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 以降が必要です。
  • Customize セクションで Status を選択するか /status と入力すると、セッションの Claude Code のバージョン、アカウント、モデル、MCP サーバーの詳細を確認できます。Claude Code v2.1.280 以降が必要です。
  • Customize セクションで Sandbox を選択するか /sandbox と入力すると、Claude の Bash コマンドがサンドボックス内で実行されるかどうかを確認できます。そこでサンドボックスモードを切り替えたり、除外コマンドを追加したりできます。Claude Code v2.1.280 以降が必要です。
  • Customize セクションで Claude in Chrome を選択するか /chrome と入力すると、Claude in Chrome の接続を確認および管理できます。いずれも claude.ai アカウントでのサインインが必要です。Claude Code v2.1.280 以降が必要です。
  • Context セクションで Export conversation を選択するか /export と入力すると、会話をプレーンテキストとしてコピーしたり、ファイルに保存したりできます。/export notes.txt のようにファイル名を付けると、ダイアログを省略してファイルの保存先を選択できます。Claude Code v2.1.280 以降が必要です。
  • 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 がサブエージェントを実行している間は、それらを開始したツール呼び出しグループの下に、最新のアクティビティを示すライブ進捗行が表示されます。これには Claude Code v2.1.269 以降が必要です。
  • Anthropic アカウントからサインアウトするには、Settings セクションで Sign out を選択するか、/logout と入力します。サードパーティプロバイダーを使用している場合、メニューにはどちらも表示されません。Claude Code v2.1.277 以降が必要です。
  • バグを報告するには、メニュー下部の Report a problem をクリックするか、/bug または /feedback と入力します。任意で説明を付けると、それがレポートにあらかじめ入力されます。ファーストパーティ接続で Anthropic にサインインしている状態でレポートを送信すると、Claude Code はそれを Anthropic に送信します。Claude Code v2.1.229 以降が必要です。 サードパーティプロバイダーを使用している場合や Anthropic の認証情報がない場合は、何も送信されません。そのことは、入力を始める前にダイアログに表示されます。送信すると、既知の API キーやトークンのパターンを伏せた上で、レポートが ~/.claude/feedback-bundles/ 配下のローカルアーカイブとして保存されます。レポートをコンピューターに保存するには Claude Code v2.1.284 以降が必要です。 レポートが保存されると、確認メッセージにファイル名が表示され、Show folder ボタンが含まれます。そのファイルを Anthropic のアカウント担当者に送るか、サポートリクエストに添付してください。 組織のポリシーで製品フィードバックがオフになっている場合、メニューに Report a problem は表示されず、/bug と /feedback はレポートを開く代わりに Feedback is turned off by your organization's policy or this environment's settings. という通知を表示します。Claude Code v2.1.284 以降では、DISABLE_FEEDBACK_COMMAND または CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 環境変数を設定した場合もフィードバックがオフになり、レポートを開こうとするとその通知が表示されます。
• サイドクエスチョン: /btw に続けて質問を入力すると、会話に追加せずにセッションについて質問できます。回答はチャットの横のパネルに開き、そこでフォローアップの質問ができます。Claude Code v2.1.227 以降が必要です。 このスレッドはウィンドウを再読み込みしても保持されます。Claude Code は最新の 20 件のやり取りを保持し、Claude Code が保持期間を安全に判断できる限り、保存されたスレッドを cleanupPeriodDays のスケジュールに従って期限切れにします。スレッドを消去するには、パネルのゴミ箱アイコンをクリックします。
• 応答をコピーする: 応答にカーソルを合わせて Copy response をクリックするとクリップボードにコピーされます。また、/copy と入力すると最新の応答をコピーできます。/copy 2 は最後から 2 番目の応答をコピーします。Claude Code v2.1.277 以降が必要です。
• ブックマーク: 応答にカーソルを合わせて Bookmark response をクリックすると保存されます。保存済みの応答で Remove bookmark をクリックすると削除されます。 保存した応答を確認するには、Bookmarks パネルを開きます。Claude Code パネル上部のブックマークアイコンをクリックするか、コマンドメニューの Context セクションで Bookmarks を選択するか、/bookmarks と入力します。Claude Code v2.1.286 以降が必要です。
• Claude から送られたファイル: セッションが Remote Control に接続されていて、Claude が SendUserFile ツールでファイルを送った場合、会話には Sent report.md, chart.png のような行が表示されます。ファイル名をクリックするとエディターで開きます。
• コンテキストインジケーター: プロンプトボックスには、Claude のコンテキストウィンドウをどれだけ使用しているかが表示されます。Claude は必要に応じて自動的に圧縮しますが、/compact を手動で実行することもできます。
• プロンプトキャッシュの時計: コンテキストインジケーターの横にある時計アイコンは、会話のプロンプトキャッシュの有効期限が切れるまでの残り時間を推定して表示します。キャッシュの 5 分または 1 時間の有効期間からカウントダウンし、キャッシュを使用する応答があるたびにカウントダウンがリセットされます。コンテキスト圧縮を除き、キャッシュを無効化するアクションでは時計はリセットされないため、モデルを切り替えた後も残り時間が表示されることがあります。
  • カウントダウンが終わるまで、アイコンには 12m のように残りの分数が表示されます。
  • カウントダウンが終わると、次の応答まで分数が消え、アイコンが赤色（またはテーマのエラーカラー）に変わります。キャッシュは期限切れになっている可能性が高いため、キャッシュが再構築される間、次のメッセージへの応答は遅く、コストも高くなると考えてください。5 分の有効期間がメッセージの間に何度も切れてしまう場合は、TTL を自分で選択するを参照してください。
  • 会話が圧縮された直後も、キャッシュが圧縮後の会話をまだカバーしていないため、次の応答までアイコンは分数なしで赤色になります。
• エージェントマップ: 会話にサブエージェントが含まれている場合、プロンプトボックス下部に 2 agents のようなエージェント数が表示されます。そのドットは、いずれかのサブエージェントが作業中か、ユーザーの権限を待っているかを示します。 エージェント数をクリックするとエージェントマップが開き、会話のサブエージェントがメインエージェントの下にツリーとして描画され、それぞれのステータス、経過時間、トークン数が表示されます。サブエージェントをクリックすると、そのプロンプトとツール呼び出しを確認したり、読み取り専用のトランスクリプトを開いたり、実行中のサブエージェントを停止したりできます。Claude Code v2.1.269 以降が必要です。 マップには、エージェントの下にセッションのその他のバックグラウンドタスク（バックグラウンドのシェルコマンドやモニターなど）も一覧表示されます。行をクリックするとタスクのカードが開き、そこで停止できます。 Claude がバックグラウンドシェルを開始したもののサブエージェントがない場合など、エージェント数が表示されていないときにマップを開くには、プロンプトボックスに /tasks と入力します。マップ内のバックグラウンドタスクと、入力による /tasks には Claude Code v2.1.277 以降が必要です。 Claude Code v2.1.286 以降では、Stop をクリックするか Esc を押すと、現在のターンが終了します。バックグラウンドエージェントは、完了するか、マップから停止するまで実行を続けます。
• 拡張思考: 複雑な問題について Claude がより多くの時間をかけて推論できるようにします。コマンドメニュー（/）からオンに切り替えます。Claude の推論は会話内に折りたたまれたブロックとして表示されます。ブロックをクリックすると内容を読むことができ、Ctrl+O を押すとセッション内のすべての思考ブロックを展開または折りたたむことができます。詳細は拡張思考を参照してください。
• 複数行入力: Shift+Enter を押すと、送信せずに改行を追加できます。これは質問ダイアログの「Other」自由記述入力でも機能します。

​

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

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

• ファイルがワークスペース内にあり、files.exclude または search.exclude の設定に一致する場合、Claude が受け取るのは最大でもファイルのパスのみで、選択したテキストは受け取りません。
• VS Code の search.useIgnoreFiles 設定と拡張機能の respectGitIgnore 設定の両方がオン（デフォルト）の場合、git が無視するファイルにも同じことが当てはまります。

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

​

プロンプトにターミナル出力を含める

​

テキストを貼り付ける

• 貼り付け時に Removed 3 invisible characters from the pasted text のような通知が表示された場合、テキストはそれらの文字を除いて入力されています。
• 送信時に削除された文字に関する通知が表示された場合、何も送信されていません。クリーンアップされたテキストはプロンプトボックスに戻されています。表示されたとおりのテキストを送信するには、再度送信してください。

​

応答内の LaTeX 数式

• ディスプレイ数式: 独立した 1 行または複数行に記述された $$ … $$ または \[ … \] ブロック、および言語が math のフェンス付きコードブロック
• インライン数式: $E = mc^2$ や \(a^2 + b^2 = c^2\) のように、同じ行で開始と終了がある $…$ または \(…\)

​

過去の会話を再開する

• セッションタイトル: 新しいセッションには、最初のメッセージに基づいて AI が生成したタイトルが付けられます。
• 名前の変更とアーカイブ: セッションにカーソルを合わせると、これらのアクションが表示されます。名前を変更してわかりやすいタイトルを付けたり、アーカイブしてリスト下部の Archived sessions グループに移動したりできます。

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• 1 つのセッション: Archived sessions を展開し、Unarchive session をクリックします。
• アーカイブしたすべてのセッションを一括で: アクティビティバーのセッションリストにある Archived sessions ヘッダーにカーソルを合わせ、そのアーカイブ解除アイコンをクリックします。Claude Code v2.1.277 以降が必要です。

• 拡張機能が claudeCode.initialPermissionMode から、または以前の会話から引き継がれた選択から開始時の権限モードを選択する場合
• claudeCode.claudeProcessWrapper を設定している場合
• 拒否ルールによって ExitPlanMode ツールが除外されている場合

​

claude.ai のクラウドセッションを再開する

​

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

• claude.ai プラン: 現在のセッションや週など、プランの制限ごとの使用量バーが表示されます。各バーには、その制限がリセットされるまでの時間が表示されます。 ダイアログでは、プランの制限に影響している要因の内訳も確認できます。キャッシュミス、長いコンテキスト、サブエージェントを多用するセッションや並列性の高いセッションなど、最近の使用量の 10% 以上を占める動作が指摘されます。指摘された動作にはそれぞれ、削減するためのヒントが示されます。帰属テーブルには、各スキル、サブエージェント、プラグイン、MCP サーバーによる使用量が表示されます。 Day と Week のトグルを使用すると、過去 24 時間と過去 7 日間を切り替えられます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスや claude.ai での使用量は含まれません。
• その他のサインイン: サードパーティプロバイダーや API キーを使用している場合など、サインイン方法にプランの制限が適用されない場合は、Usage セクションに代わりにセッション自体のコストとトークン使用量が表示されます。CLI の /usage でも、Session ブロックに同じ合計が表示されます。アクティビティバーのセッションリストにも、Account & usage ヘッダーの下にアクティブなセッションの合計が表示されます。Claude Code v2.1.277 以降が必要です。

​

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

• Fork conversation from here: すべてのコード変更をそのまま保持しつつ、このメッセージから新しい会話の分岐を開始します
• Rewind code to here: 会話履歴全体を保持しつつ、ファイルの変更を会話のこの時点まで元に戻します
• Fork conversation and rewind code: 新しい会話の分岐を開始し、ファイルの変更をこの時点まで元に戻します

​

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

​

Claude の配置場所を選ぶ

• セカンダリサイドバー：ウィンドウの右側です。コーディング中も Claude を表示したままにできます。
• プライマリサイドバー：エクスプローラーや検索などのアイコンがある左側のサイドバーです。
• エディター領域：Claude をファイルと並ぶタブとして開きます。サイドタスクに便利です。

​

リロード後に会話を続ける

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

​

リロード後に中断されたステップ

​

リロード後の続行をオフにする

​

会話が再度開かれなかった

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• それでも開く場合：Open it anyway をクリックするか、セッション履歴から会話を選択します。会話が開いてパネルが正常に動作し続ければ、以降のリロード後も通常どおり復元されます。パネルが再び応答しなくなった場合は、ウィンドウをリロードすると、通知付きの新しいチャットに戻ります。
• 閉じたままにする場合：新しいチャットで作業を続けてください。プロンプトを送信すると通知は消えます。

​

複数の会話を実行する

​

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

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

​

セッションリストをフィルタリングする

• Active：このトグルをオンにすると、入力が必要なセッション、処理中のセッション、未読のセッションと、最後にフォーカスした Claude タブのセッションのみが表示されます。
• ステータスでフィルタリング：じょうごアイコンをクリックし、Needs input、Working、または Completed にチェックを入れると、それらのいずれかの状態にあるセッションが表示されます。Open または Closed にチェックを入れると、セッションが開いているかどうかで絞り込めます。このウィンドウにタブがある場合、またはこのマシン上の別の Claude Code プロセス（ターミナルなど）で実行中の場合、セッションは開いているとみなされます。

​

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

​

プラグインを管理する

​

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

• インストール済みのプラグインは上部に表示され、トグルスイッチで有効化または無効化できます。
  • プロジェクトの共有 .claude/settings.json でオンになっているプラグインをオフにしようとすると、拡張機能が事前に確認します。Disable for me は自分だけに対してオフにし、Disable for everyone は共有ファイルを変更します。
  • 読み込みに失敗したプラグインの行には、短い理由が表示されます。理由をクリックすると対処方法が表示されます。これには、プラグインのトラブルシューティングで調べるために完全なエラーメッセージをコピーする操作も含まれます。
• 設定済みのマーケットプレイスから利用可能なプラグインがその下に表示されます
• 検索して、名前または説明でプラグインを絞り込めます
• 利用可能なプラグインの Install をクリックします

• Install for you: すべてのプロジェクトで利用可能（ユーザースコープ）
• Install for this project: プロジェクトの共同作業者と共有（プロジェクトスコープ）
• Install locally: 自分だけ、このリポジトリ内のみ（ローカルスコープ）

​

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

• プロジェクトの共有 .claude/settings.json でオンになっているプラグイン: Disable for me を選択すると、共同作業者のためにプラグインはインストールされたままになります。Uninstall for everyone を選択すると、--keep-data を指定してプロジェクトのインストールが削除されるため、プラグインの保存データディレクトリは残ります。すでに自分に対してプラグインをオフにしている場合は、ゴミ箱アイコンをクリックすると、確認なしで自分のインストールが削除されます。
• それ以外で、保存データを持つプラグインの最後のインストール: データを保持するか削除するかを選択します。デフォルトは Keep です

​

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

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

• プラグイン名: 最大 100 文字で、ASCII 英字または数字で始まり、それ以外は ASCII 英字、数字、.、_、- のみを使用する必要があります。
• マーケットプレイスのソース: marketplace パラメータに記載された形式のみが使用できます。ローカルパス、http:// アドレス、claude-plugins-official のようなマーケットプレイス名は使用できません。https:// URL にはユーザー名、パスワード、クエリ文字列を含めることはできません。
• Git ref: マーケットプレイスをブランチまたはタグに固定するには、marketplace=owner/repo%23v1.0 のように、# をエンコードした形式である %23 の後に ref をソースに追加します。エンコードされていない # を含むリンクは失敗します。anthropics GitHub 組織内のマーケットプレイスは、リンクで固定できません。

• マーケットプレイスにその名前のプラグインが掲載されていない: ダイアログに、プラグインが見つからなかったことが表示されます。plugin の値をマーケットプレイスの掲載内容と照らし合わせて確認してください。
• プラグインがすでにインストールされている: ダイアログにその旨が表示され、何も変更されません。
• 同じ名前の別のマーケットプレイスがすでに追加されている: ダイアログに、リンクのマーケットプレイスが追加されなかったことが表示され、何もインストールされません。

​

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

• GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します
• 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します
• ゴミ箱アイコンをクリックして、マーケットプレイスを削除します。削除するとそこからインストールしたすべてのプラグインがアンインストールされるため、まず確認画面でそれらのプラグインが表示されます

​

パネルに描画するプラグイン

• 会話の横またはプロンプトボックスの上にあるペイン
• プロンプトボックスの上に表示されるトーストまたはステータスライン
• プラグイン独自の方法で描画されたメッセージまたはツール呼び出し

• From the token-chart plugin: プラグインがこれを描画または出力した、あるいはこのカードはプラグインからの問いかけである
• Edited by the token-chart plugin: プラグインが、ツール呼び出しなど Claude Code が描画するものを変更した
• Prompt from the token-chart plugin: プラグインがユーザーに代わってこのメッセージを送信した

​

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

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

• デフォルトで Chrome を有効にする: @browser と入力しなくても、各セッションの開始時にブラウザへ接続するようにします
• VS Code セッションでの権限プロンプト: Claude Code がブラウザ操作の前に確認を求めるタイミング
• Chrome で Claude Code を使用する: セットアップ手順、機能の一覧、トラブルシューティング

​

git で作業する

​

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

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

​

バックグラウンドで作業を実行する

​

実行中のコマンドまたはサブエージェントをバックグラウンドに移動する

• タイミング：このアクションは、コマンドが約 2 秒間実行された時点、またはサブエージェントが開始された直後に表示されます。
• クリック後：Claude は待機をやめてターンを続行します。コマンドまたはサブエージェントは、完了時に Claude に通知するバックグラウンドタスクとして実行を続けます。

​

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

​

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

​

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

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"

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

​

設定を構成する

• VS Code の拡張機能設定：VS Code 内での拡張機能の動作を制御します。Cmd+,（Mac）または Ctrl+,（Windows/Linux）で開き、Extensions > Claude Code に移動します。/ と入力して General config… を選択して設定を開くこともできます。
• ~/.claude/settings.json の Claude Code 設定：拡張機能と CLI の間で共有されます。許可するコマンド、環境変数、フック、MCP サーバーに使用します。Claude Code v2.1.283 以降では、会話が開始される権限モードを決める入力の 1 つにもなります。それより前のバージョンでは、Pro、Max、Team プランでのみ該当します。順序については権限モードを切り替えるを参照してください。詳細は設定を参照してください。

​

拡張機能設定

​

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

​

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

• Claude の返信: 拡張機能は各返信を完了時に 1 回だけ読み上げ、テキストのストリーミング中は何も読み上げません。スクリーンリーダーは、コードブロックを行数の要約として、リンクをラベルで、テーブルをセルごとに読み上げます。返信の全文はトランスクリプトで引き続き読むことができます。
• 権限リクエストと質問: 拡張機能は、権限プロンプトが表示されたときに、Claude が使用しようとしているツール名を含めてリクエストを読み上げます。Claude がユーザーに質問したときや、Claude がプランを完成させてユーザーのレビューを待っているときも、同様に読み上げます。
• ステータスの変化: 拡張機能は、Claude が作業を開始したとき、Claude がユーザーの入力を受け付ける準備ができたとき、Claude Code が会話のコンパクト化を開始したときに読み上げます。
• キューに入れられたメッセージ: Claude の作業中にメッセージを送信すると、拡張機能はそのメッセージについて「Message queued.」と読み上げます。
• エラーとモデルのプロンプト: 拡張機能は会話中のエラーを読み上げるほか、使用クレジットの同意プロンプトやフラグ付きリクエストのプロンプトが表示されたときにも読み上げます。

​

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

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

• その選択肢にフォーカスした状態で、Left または Right の矢印キーを押します。拡張機能は、移動先の保存先をそれぞれ読み上げます。矢印キーを使用するには、Claude Code v2.1.268 以降が必要です。
• ラベル内の保存先をクリックします。

​

VS Code 拡張機能と Claude Code CLI の比較

​

VS Code で CLI を実行する

​

拡張機能と CLI を切り替える

​

MCP で外部ツールに接続する

• サーバーを追加する
• ローカル、ユーザー、またはプロジェクトのスコープに保存されたサーバーを削除する
• サーバーを有効化または無効化する
• サーバーに再接続する
• OAuth 認証を管理する

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

​

組み込みの IDE MCP サーバー

• VS Code のネイティブ差分ビューアーで差分を開く
• @ メンションのために現在の選択範囲を読み取る
• Jupyter ノートブックで作業している場合に、VS Code にセルの実行を依頼する

• キューに入れたメッセージ: Claude の作業中にメッセージをキューに入れた場合、その後に何を選択しても、Enter を押した時点の選択範囲が保持されます。
• 機密ファイル: .env などの機密ファイルを除外するには、そのパスに対する Read 拒否ルールを追加します。一致する拒否ルールがあると、そのファイルの選択テキストと開いているファイルの通知のどちらも Claude に届かなくなります。
• Attach Open File がオフの場合: Attach Open File 設定をオフにすると、CLI はアクティブなファイル内でテキストを選択している間だけ、そのファイルのパスを受け取ります。

• トランスポート: 暗号化されていない ws:// です。ソケットはループバック専用であるため、通信を傍受できるプロセスであればロックファイルからトークンも読み取れます。そのため、TLS を使用しても保護は強化されません。
• 認証トークン: 拡張機能が有効化されるたびに新しいランダムな認証トークンが生成され、~/.claude/ide/<port>.lock のロックファイルに書き込まれます。CLI が接続するには、このトークンを X-Claude-Code-Ide-Authorization ヘッダーとして提示する必要があります。
• ロックファイルの権限: ロックファイルは 0700 のディレクトリ内で 0600 の権限を持つため、VS Code を実行しているユーザーだけが読み取れます。CLAUDE_CONFIG_DIR が設定されている場合、ロックファイルは代わりに $CLAUDE_CONFIG_DIR/ide/ に書き込まれます。

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. コードがアクティブなノートブックの末尾に新しいセルとして挿入されます。
2. VS Code がそのセルを表示位置までスクロールします。
3. ネイティブの Quick Pick で Execute または Cancel を選択するよう求められます。

​

よくある問題の解決

​

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

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

​

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

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

​

macOS で Cmd+Esc を押しても何も起こらない

1. システム設定を開きます
2. キーボード、キーボードショートカット、ゲームコントローラの順に移動します
3. Game Overlay のチェックボックスをオフにします

​

再開した会話が最初は空白になる

​

リロードで会話が再度開かれるたびにパネルが応答しなくなる

​

数式が LaTeX のまま表示される

• 数式以外のものとして解釈される: 単語として解釈される $…$ のテキスト（$O(n log n)$ など）は書かれたまま表示されます。$30$ や $1/N$ のように数字で始まる $…$ のテキストも、=、+、^ などの文字で数式であることが示されていない限り、書かれたまま表示されます。代わりに、独立した行に置いた $$ ブロックを使うよう Claude に依頼してください。パネルはこのチェックを行わずに $$ ブロックを組版します。
• スペースで囲まれている、長い、または複数行にまたがっている: ドル記号の内側にスペースがある $ x^2 $、60 文字を超える $…$ の内容、2 行にまたがる $…$ や \(…\) は組版されません。代わりに、独立した行に置いた $$ ブロックを使うよう Claude に依頼してください。$$ ブロックにはこれらの制限はありません。
• TeX を組版できない: 構文エラーを含む数式、\newcommand や \def などのマクロ定義、エスケープされていない % を含む数式は、書かれたまま表示されます。エラーを修正する、マクロを使わない、またはパーセント記号に \% を使うように書き直すよう Claude に依頼してください。
• 大きすぎる: 8,192 文字を超える数式や、ソースよりもはるかに大きく描画される数式は、書かれたまま表示されます。より小さな数式に分割するか、よりコンパクトに書くよう Claude に依頼してください。
• 大量の数式の後にある: 応答内の 1 つのテキストブロックでは、パネルは上限に達するまで数式を順番に組版します。上限を超える後続の数式は書かれたまま表示されます。必要な数式を単独でもう一度送信するよう Claude に依頼してください。

​

Claude Code がまったく応答しない

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

​

拡張機能のアンインストール

1. Mac では Cmd+Shift+X、Windows/Linux では Ctrl+Shift+X を押して拡張機能ビューを開きます
2. 「Claude Code」を検索します
3. Uninstall をクリックします

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

​

次のステップ

• 一般的なワークフローを確認することで、Claude Code を最大限に活用できます
• MCP サーバーをセットアップすることで、外部ツールを使って Claude の機能を拡張できます。MCP サーバーの追加と管理は、チャットパネルで /mcp を使って行います。
• Claude Code の設定を構成することで、許可するコマンドやフックなどをカスタマイズできます。これらの設定は拡張機能と CLI の間で共有されます。
• Claude Code のセキュリティ保護機能とデータの使用を確認しましょう