Claude CodeをVS Codeで使う方法!拡張機能の入れ方と設定も紹介

VS CodeでClaude Codeを使おうと調べると、拡張機能を入れる手順とターミナルで起動する手順が混在しています。両方を準備する必要があるのか判断するには、チャットパネルとCLIの違いを知ることが大切です。
この記事を読めば、Claude Codeの公式拡張の入れ方と基本操作、設定やトラブルの確認方法が分かります。VS Codeの中でAIへ依頼し、変更内容を確かめるまでの流れも理解できます。チャットパネルを使うだけなら、原則としてCLIを別に導入する必要はありません。ただし、利用アカウントと権限モードの確認は必要です。
目次
- Claude CodeのVS Code拡張をインストールする手順
- Claude CodeのVS Code拡張でできること【CLIとの違い】
- VS CodeでClaude Codeに指示して変更を確認する方法
- Claude CodeのVS Code拡張の計画・復元機能と表示の設定
- VS CodeでClaude Codeが動かないときの対処法
- Claude CodeのVS Code拡張に関するよくある質問
- まとめ
- 参考リンク
Claude CodeのVS Code拡張をインストールする手順
Claude CodeのVS Code拡張は、VS Codeの拡張ビューから検索して入れます。名前の似た非公式の拡張が並ぶこともあるため、発行元とログインの方法まで確かめながら進めることが大切です。Claude CodeのVS Code拡張をインストールしてログインするまでにやることは、以下の3点です。
- 拡張ビューで「Claude Code」を検索して入れる
- 発行元がAnthropicであることを必ず確認する
- ログインはブラウザ認証で完了する
拡張ビューで「Claude Code」を検索して入れる
Claude CodeのVS Code拡張をインストールする手順は、以下のとおりです。
- VS Code左側の四角いアイコン(拡張ビュー)を開く(WindowsはCtrl+Shift+X、MacはCmd+Shift+X)
- 検索欄に「Claude Code」と入力する
- 「Claude Code for VS Code」を選び、発行元Anthropicを確認する
- Installボタンを押す
Claude Code公式ドキュメントによると、対応するバージョンはVS Code 1.94.0以降です。一方、Visual Studio Marketplaceには1.98.0以降と掲載されており、記載が一致していません。導入時は、Marketplaceに記載された1.98.0以降も満たすバージョンを使用してください。古いバージョンのままでも動作するとは断定できません。
発行元がAnthropicであることを必ず確認する
インストール前に、発行元(Publisher)がAnthropic、拡張IDがanthropic.claude-codeであることを確認してください。人気ツールには、名前の似た非公式の拡張が並ぶことがあります。発行元の確認は、AIツール全般で身につけたい習慣です。
Claude Codeの公式拡張は、Visual Studio Marketplaceに掲載されています。CursorのようなVS Code系のエディタ向けにも、公式の導入リンクがあります。エディタによって細部の入れ方は違っても、発行元を確かめる原則は共通です。
ログインはブラウザ認証で完了する
Claude Codeの拡張のパネルを初めて開くと、サインイン画面が表示されます。Sign inを選び、ブラウザで対象のアカウントへログインして認証します。通常のClaudeアカウントでのサインインに、APIキーの貼り付けは不要です。
Claude Codeの利用には、Pro・Max・Team・Enterpriseなどの有料プラン、またはClaude Consoleのアカウントを使用します。Claude Consoleは、従量課金で使う経路です。会社の契約を使う場合は、管理者から案内されたアカウントを選びます。
有料プラン内の利用枠と追加の利用料金、API経由の課金は、それぞれ区別する必要があります。別のアカウントへ新たに契約する前に、現在使える契約と認証方法を確認しましょう。
Claude CodeのVS Code拡張でできること【CLIとの違い】
Claude CodeのVS Code拡張は、エディタの画面の中でAIに作業を依頼するための公式の拡張機能です。チャットパネルとCLIでは準備や使える機能が異なるため、違いを知っておくと自分に合う使い方を選びやすくなります。Claude CodeのVS Code拡張について押さえておきたいことは、以下の3点です。
- 公式拡張はエディタの画面の中でClaude Codeを動かす
- 拡張にClaude Code本体が同梱されているため別途インストールする必要はない
- ターミナル版との機能差を確認して選ぶ
公式拡張はエディタの画面の中でClaude Codeを動かす
Anthropicの公式拡張「Claude Code for VS Code」は、エディタ内にチャットパネルを追加する機能です。開いているプロジェクトのファイルについて、調査や作成、修正を日本語で依頼できます。
変更前後の違いを示す差分ビューや、計画へコメントする機能も使えます。Claude CodeのVS Code拡張は、AIとの会話とファイルの確認を同じエディタ内で進めたい場合に向く入口です。
拡張は無料ですが、AIの利用料金は別です(詳細はよくある質問で解説)。
拡張にClaude Code本体が同梱されているため別途インストールする必要はない
公式拡張には、チャットパネル用のClaude Code本体が同梱されています。対応する環境では、先にターミナルでCLIをインストールする必要はありません。CLIは、文字のコマンドで操作する形式です。
CLI版のClaude Codeの特徴と、インストールから使い方・コマンドまでは以下の記事で解説しています。
Claude Code CLIとは?インストールから使い方・コマンドまで解説
ただし、拡張を入れてもターミナルから使うclaudeコマンドは登録されません。パネルでの利用と、ターミナルでコマンドを実行する利用では準備が異なります。
環境によっては、同梱の実行ファイルが対応しておらず、追加の設定が必要です。インストール後に「Unsupported platform」と表示されたときは、同梱の本体が自分の環境に対応していない状態です。Claude Code公式ドキュメントには、別に導入したCLIを拡張から使う設定(claudeProcessWrapper)が用意されています。
ターミナル版との機能差を確認して選ぶ
VS Code拡張とターミナル版は、使える機能を確認して選びます。拡張の画面で計画や差分を確認したい場合と、コマンドで自動化したい場合では、向く操作が異なるからです。
Claude CodeのVS Code拡張とターミナル版(CLI)の主な違いは、以下の表のとおりです。
| 項目 | VS Code拡張 | ターミナル版(CLI) |
|---|---|---|
| 操作画面 | チャットパネル | コマンドを入力する画面 |
| コマンド・スキル | 一部に対応 | 拡張より広い範囲に対応 |
| MCPの管理 | 対応バージョンでは画面で操作可能 | コマンドで設定可能 |
| チェックポイント | 利用可能 | 利用可能 |
| 準備 | パネル用の本体を同梱 | 単独のCLIを導入 |
拡張とCLIでは会話履歴を共有でき、CLIのclaude --resumeから拡張での会話を再開できます。一方、パネルの位置など拡張独自の設定もあるため、拡張とCLIのすべての設定が同じではありません。
Claude Codeの導入から、日本語での依頼・変更確認までの使い方は以下の記事で解説しています。
Claude Codeの使い方を解説!導入から日本語での依頼・変更確認まで
VS CodeでClaude Codeに指示して変更を確認する方法
Claude Codeに作業を任せるときは、依頼の出し方に加えて、変更内容を確かめる方法を知っておくことが大切です。権限モードによっては、ファイル編集が個別の確認なしで進むためです。VS CodeでClaude Codeに依頼してから変更を確認するまでの基本操作は、以下の3つです。
- Sparkアイコンからパネルを開いて日本語で指示する
- 権限モードを確認して差分を点検する
- ファイルは@メンションと選択範囲で渡す
Sparkアイコンからパネルを開いて日本語で指示する
ファイルを開くと、エディタ右上にSpark(火花)のアイコンが表示されます。Sparkアイコンをクリックすると、Claude Codeのパネルが開きます。パネルでは「このファイルの構成を日本語で説明して」のように依頼してください。
Sparkアイコンが見つからない場合は、コマンドパレットでClaude Codeを検索し、Open in New Tabから開く方法もあります。
最初の指示は、ファイルを何も変更しない、読むだけの依頼にすると安全です。パネルは画面の左右どちらにも配置でき、過去のセッション履歴から会話を再開できます。
権限モードを確認して差分を点検する
変更の確認方法は、パネル下部に表示される権限モードによって変わります。Manualモードでは、ファイル編集の前に変更案を確認し、承認や却下を選ぶ仕組みです。
一方、AutoやEdit automaticallyでは、多くのファイル編集が個別の確認なしで進みます。差分ビューがあるから必ず反映前に止まる、とは考えないでください。
Claude Code公式ドキュメントによると、Pro・Max・Teamでは既定の開始モードがAutoです。初回はパネル下部の表示でモードを確かめてから依頼してください。
差分を読む際は、依頼した箇所以外の変更や設定ファイルの修正にも目を向けます。差分の内容を見ただけでは動作の正しさまで分からないため、テストや画面の確認も必要です。権限モードの切り替え方の詳細は、Claude Code公式ドキュメントの権限モードのページに掲載されています。
ファイルは@メンションと選択範囲で渡す
特定のファイルについて頼むときは、入力欄で@を打ちます。ファイル名の検索が開き、対象のファイルを指示に添付できます。@メンションは、フォルダやPDFのページ指定にも対応しています。
@メンションより直感的なのが、選択範囲の共有です。エディタでコードや文章を選択すると、選択した範囲をClaudeが参照できます。選択範囲を共有する設定が有効か、入力欄の表示で確かめてください。
行を指定して参照させるショートカットも用意されています。対象ファイルと行番号を明示して依頼したいときに使えます。
Claude CodeのVS Code拡張の計画・復元機能と表示の設定
Claude CodeのVS Code拡張には、AIの計画を実行前に確かめるPlanモードと、編集を以前の状態へ戻すチェックポイントがあります。パネルの配置などの表示も、VS Codeの設定で変えられます。Claude CodeのVS Code拡張の計画・復元・表示について、押さえておきたい点は以下の3つです。
- Planモードで実行前の計画にコメントできる
- チェックポイントの復元範囲を確認する
- パネルの配置や表示方式は設定で変えられる
Planモードで実行前の計画にコメントできる
大きめの変更を頼むときは、実行前に計画を確認するPlanモードが役立ちます。Claude Code公式ドキュメントによると、拡張ではAIの立てた計画がMarkdownの文書として開きます。開いた計画の文書に直接コメントを書き込んで、方針を直せる仕組みです。
計画を読むときは、変更するファイルと期待する動作を確認します。Planモードでも、調査のためのコマンドが動く場合があります。すべての実行が止まるモードとは考えないことが大切です。
チェックポイントの復元範囲を確認する
チェックポイントは、Claudeの編集ツールが変更したファイルを以前の状態へ戻す機能です。メッセージに表示される巻き戻しボタンから、コードの復元や会話の分岐を選べます。
ただし、チェックポイントでは、コマンドで削除・移動したファイルや外部サービスへの操作までは戻せません。復元対象に含まれない変更や、保存済みのスナップショットが残っていない場合もあります。
長期の変更履歴はGitなどで別に管理する必要があります。Gitは、ファイルの変更を記録する仕組みです。チェックポイントをバックアップの代わりにせず、変更前の状態を残して作業を進めましょう。復元の対象外となる変更は、Claude Code公式ドキュメントのチェックポイントのページで確認できます。
パネルの配置や表示方式は設定で変えられる
Claude Codeの拡張の見た目や挙動は、VS Codeの設定から調整できます。チャットパネルを左右どちらに置くかに加えて、パネルをやめてターミナル風の表示で使う設定(useTerminal)も選べます。
AIが一度に扱える会話量は、パネルのコンテキスト表示で確認します。/compactで会話を要約して整理できます。外部ツールへ接続するMCPの管理画面は、/mcpで開けます。画面でのMCPサーバーの追加・削除は、Claude Code v2.1.261以降が対象です。バージョンによって、利用できる操作が異なります。
VS CodeでClaude Codeが動かないときの対処法
VS CodeでClaude Codeが動かない場合は、症状を分けて原因を調べます。拡張の表示・認証・コマンドのどこで止まっているかによって、確認する場所が異なるためです。VS CodeでClaude Codeが動かないときに確認したい症状と対処は、以下の3つです。
- 拡張やアイコンが表示されないときは公式の手順に沿って確認する
- 認証できないときはログイン方法を確認する
- claudeコマンドが見つからないときはCLIの導入を確認する
拡張やアイコンが表示されないときは公式の手順に沿って確認する
拡張が検索に出ない場合や、入れたのにSparkアイコンが出ない場合は、公式のトラブル対処の手順に沿って確認します。Claude Codeの拡張やアイコンが表示されないときに確認する手順は、以下のとおりです。
- VS Codeのバージョンが要件を満たしているか確かめる
- 何かファイルを1つ開いてみる(アイコンが出ない定番の原因)
- コマンドパレットからReload Windowでウィンドウを再読み込みする
- ほかのAI補助拡張を一時的に無効化する(競合の切り分け)
VS Codeで信頼していないフォルダを開いたときの制限モード(Restricted Mode)では、Claude Codeの拡張が動きません。拡張を動かすためだけに不明なフォルダを信頼せず、フォルダの内容と入手元を確認してください。
認証できないときはログイン方法を確認する
未ログインの表示が出る場合は、パネルのサインイン画面で再認証します。サインイン画面が開かないときは、Developer: Reload Windowによる再読み込みが対処の候補です。
APIキーを環境変数に設定したのにサインインを求められる場合は、VS Codeが環境変数を引き継いでいない可能性があります。環境変数は、アプリへ動作条件を伝える設定です。VS Codeが環境変数を引き継いでいないときの対処として、Claude Code公式ドキュメントはターミナルからcode .で起動する方法を案内しています。
code .は認証の問題すべてを直すコマンドではありません。通常のClaudeアカウントを使うなら、ブラウザでの認証が選択肢です。認証方法は、ログイン先と利用する契約に応じて異なります。
claudeコマンドが見つからないときはCLIの導入を確認する
拡張だけを入れた環境では、ターミナルでclaudeと入力しても「見つからない」と表示される場合があります。パネル用の本体と、ターミナルから使えるコマンドが別だからです。Claude Code公式ドキュメントによると、拡張に同梱された本体はパネル専用で、コマンドとしては登録されない仕様です。
ターミナルでもclaudeコマンドを使いたい場合は、CLI版を別途インストールします。CLIを導入したのに見つからない場合は、コマンドの検索先であるPATHの確認が必要です。
Claude CodeのCLIをWindows・Macに入れる方法は、以下の記事で解説しています。
Claude CodeのインストールをWindows・Mac別に徹底解説!日本語対応も紹介
Claude CodeのVS Code拡張に関するよくある質問
Claude CodeのVS Code拡張を導入する前に気になりやすい、料金・対応エディタ・日本語での使い方の疑問に回答します。Claude CodeのVS Code拡張について、導入前によくある質問は以下の3つです。
- 拡張機能は無料ですか?
- Cursorでも使えますか?
- 日本語で使えますか?
拡張機能は無料ですか?
Claude CodeのVS Code拡張のインストールは無料です。ただし、Claude Codeの利用には有料のClaudeプランやConsoleなどの契約が必要になります。
Claudeの個人向けプランの月払い料金と、Claude Codeの扱いは以下の表のとおりです。
| プラン | 月払いの基本料金(ドル) | Claude Code |
|---|---|---|
| Pro | 20ドル | 利用枠に含む |
| Max 5x | 100ドル | 利用枠に含む |
| Max 20x | 200ドル | 利用枠に含む |
税や地域ごとの条件は購入時に確認してください。価格と対象機能は、Claude公式サイトの料金ページに掲載されています。Max 20xの金額は、Claudeヘルプセンターの「What is the Max plan?」に掲載された数字です。
Proなどの利用枠で使う場合と、Console経由で従量課金する場合では請求の仕組みが違います。有料プランでも、追加利用の設定によって別途料金が生じます。「拡張が無料なら利用も無料」とは判断できません。
Cursorでも使えますか?
使えます。Claude Code公式ドキュメントには、Cursor向けの導入リンクが用意されています。VS Codeから派生した一部のエディタ向けには、別の拡張の配布経路(Open VSX)での提供も案内されています。
日本語で使えますか?
日本語で依頼できます。「このファイルの構成を日本語で説明して」のように、回答の言語も依頼に含めると意図を伝えやすくなります。
VS Codeのメニュー表示と、Claudeが回答する言語は別です。本文では、メニュー名やエラーを探しやすいように英語の表示も併記しています。
入力の不具合が起きたときは、OSと拡張のバージョンを記録して原因を切り分けます。
まとめ
Claude CodeのVS Code拡張は、エディタ内でAIへの依頼とファイルの確認を進める入口です。対応環境ではパネル用の本体が同梱されているため、CLIを別に導入せずに始められます。
Claude CodeのVS Code拡張を使う前に確認する項目は、以下のとおりです。
- 公式拡張の発行元と対応環境
- 利用アカウントと課金の方法
- 現在の権限モードと変更してよい範囲
- 差分・テスト・成果物の確認方法
最初は、変更しても困らない作業用フォルダで試してください。ファイルの説明を依頼して、Claude Codeが対象を正しく読めているかを確かめましょう。確かめてから小さな修正へ進むと、操作と確認の流れをつかめます。



