Claude Code VS Code拡張機能の使い方 — インストール手順とCLI・JetBrainsとの違い
Claude CodeのVS Code拡張は、エディタのパネルで差分レビューや@メンション、計画のレビューができる公式拡張です。拡張自体は無料で、Pro以上のプランかConsoleアカウントでサインインすれば始められます。
Claude CodeのVS Code拡張機能とは
Claude CodeのVS Code拡張機能は、AIコーディングエージェントのClaude Codeを、VS Codeのパネルから操作できる公式拡張です。ターミナルを開かずに、チャット欄で頼み、差分を見て、受け入れるか決められます。VS CodeでClaude Codeを使う方法として、Anthropicが推奨しているのもこの拡張です。
VS Code拡張でできること
インライン差分でのレビュー
Claudeの編集案を元のコードと並べて表示し、受け入れ・却下・別の指示を選べます。変更を1か所ずつ受け入れることもできます。
@メンションと選択範囲
@でファイルやフォルダを指定できます。エディタで選んだ行は、自動でClaudeに渡ります。計画のレビュー
Planモードの計画をMarkdown文書で開き、コメントを付けてから着手させられます。
サイドバーと複数タブ
パネルは右・左のサイドバーやエディタタブに置けます。会話を複数のタブやウィンドウで並行して進められます。
チェックポイントで巻き戻し
メッセージ単位で、コードや会話を以前の状態に戻せます。
拡張はチャットパネル用に、CLI(コマンドラインインターフェース)のコピーを同梱しています。ただしPATHには追加されません。統合ターミナルでclaudeと打って使うには、CLIを別にインストールします。この境目は後の節で詳しく扱います。
Claude Code VS Code拡張の料金と必要なもの
拡張機能そのものは無料です。費用がかかるのは、サインインに使うClaudeのプランか、Claude Console(API従量課金)の利用分です。
VS Code拡張を使うのに必要なプランの価格(税抜の米ドル)
拡張機能
$0
Marketplaceから無料で入る
Pro
$20/月
年払いは$200一括(月あたり$17)
Max
$100/月から
Proの5倍または20倍の使用量
サインインに使えるのは、有料のClaudeサブスクリプション(Pro / Max / Team / Enterprise)か、Claude Consoleのアカウントです。どちらもAPIキーの入力は要りません。拡張から使った分は、そのプランの使用量枠を消費します。枠が足りるか不安な場合は、Claude Codeの料金とプランの選び方で見積もれます。VS Codeは1.94.0以上が必要で、Help → Aboutで確かめられます。
Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry経由でClaudeを使う組織は、サインインの代わりにプロバイダーを設定します。この場合、使用量バー・音声入力・Webタブのようにclaude.aiアカウント前提の機能は出ません。
Claude CodeをVS Codeに入れる3ステップ
インストールに、CLIのセットアップは要りません。拡張機能ビューで検索して入れ、サインインすれば最初の指示を出せます。
VS Code拡張のインストールから最初の指示まで
- 1
拡張機能ビューで入れる
Cmd+Shift+X(Mac)またはCtrl+Shift+X(Windows/Linux)で拡張機能ビューを開きます。「Claude Code」を検索し、発行元がAnthropicのanthropic.claude-codeをインストールします。 - 2
パネルを開いてサインインする
エディタ右上のSparkアイコン(✱)を押すと、初回はサインイン画面が出ます。「Sign in」を押し、ブラウザで認可を済ませます。
- 3
最初の指示を送る
コードの説明・バグの調査・修正など、やりたいことをプロンプト欄に書いて送ります。行を選んでから聞くと、その範囲がClaudeに渡ります。
入れたのに拡張が見当たらないときは、VS Codeを再起動するか、コマンドパレットで「Developer: Reload Window」を実行します。サインイン後に出る「Learn Claude Code」のチェックリストでは、基本操作をその場で試せます。
拡張機能ビューに出る拡張のバージョン番号は、同梱しているClaude Codeのバージョンと同じです。たとえば「v2.1.286以降が必要」と書かれた機能は、拡張のバージョンが2.1.286以上なら使えます。GitHub Copilotなど既存のAI拡張を入れている環境では、併用時の設定を先に見ておくと安心です。
CursorなどVS Codeフォークに入れる場合
拡張はVS Codeから派生したエディタでも動きます。Cursorには専用のインストールリンクがあり、Devin DesktopやKiroなど他のフォークにも入ります。拡張機能ビューで見つからないときは、Open VSXレジストリから取得します。
それでも入らないエディタでは、統合ターミナルでclaudeを実行し、CLIとして使います。CursorからClaude Codeへ移るなら、CursorのAI機能との違いを先に押さえておけます。EclipseのようにVS Code派生でもJetBrains製品でもないIDEは拡張を入れられず、CLIで使うしかありません(Claude CodeはEclipse非対応)。
Claude CodeのVS Code拡張とCLI・JetBrains・Desktopの違い
どの入口も、中で動くエンジンは同じClaude Codeです。違うのは操作の画面と、使える機能の範囲です。設定ファイル・プロジェクトのメモリ・MCPサーバーは、手元で動く入口どうしで共有されます。
| 入口 | 画面 | 向いている使い方 | 差分の見方 |
|---|---|---|---|
| VS Code拡張 | 画面チャットパネル | 向いている使い方VS Codeを離れずに頼む・レビューする | 差分の見方パネルとVS Codeの差分ビュー |
| CLI | 画面ターミナル | 向いている使い方スクリプト・リモートサーバー・全機能 | 差分の見方ターミナル(IDE接続時はIDE側) |
| JetBrainsプラグイン | 画面IDEのターミナル | 向いている使い方IntelliJやPyCharmを使い続ける | 差分の見方IDEの差分ビューア |
| Desktopアプリ | 画面専用アプリのCodeタブ | 向いている使い方並列セッション・アプリのプレビュー | 差分の見方アプリの差分ビューア |
機能が最もそろっているのはCLIです。スクリプトからの実行とAgent SDKはCLIだけのものです。VS Code拡張とDesktopは、CLIの機能の一部と引き換えに、画面での差分レビューとエディタとの連携を得ています。
VS Code拡張とDesktopアプリの選び分け
VS Code拡張
普段のエディタでファイルを開いたまま頼めます。選択範囲や開いているファイルが自動で文脈に入ります。
Desktopアプリ
Gitで分離した並列セッション、アプリのプレビュー、Pro・Maxでのコンピュータ操作が使えます。ファイルは「Open in」からVS Codeで開けます。
Desktopアプリを選ぶ場合は、CLI・Web版との違いも比べておくと選びやすくなります。
JetBrainsプラグインとの違い
JetBrainsプラグインはチャットパネルを持たず、IDEの統合ターミナルでCLIを動かして接続します。CLIを同梱していないため、先にCLIを入れておきます。claudeがPATHに無いと「Cannot launch Claude Code」という通知が出ます。
| 観点 | VS Code拡張 | JetBrainsプラグイン |
|---|---|---|
| 対応エディタ | VS Code拡張VS Code 1.94.0以上、Cursorなどのフォーク | JetBrainsプラグインIntelliJ IDEA / PyCharm / Android Studio / WebStorm / PhpStorm / GoLandなど |
| 画面 | VS Code拡張チャットパネル(ターミナルモードも選べる) | JetBrainsプラグインIDEのターミナルで動くCLI |
| 差分の表示 | VS Code拡張パネル+VS Codeの差分ビュー | JetBrainsプラグインIDEの差分ビューア(/configのDiff toolで切り替え) |
| ファイル参照の挿入 | VS Code拡張Option+K / Alt+K | JetBrainsプラグインCmd+Option+K / Alt+Ctrl+K |
| 許可モードの切り替え | VS Code拡張プロンプト欄下のモード表示 | JetBrainsプラグインCLIと同じShift+Tab |
プラグインはJetBrains Marketplaceの「Claude Code [Beta]」を入れ、IDEを再起動して使います。リモート開発では、手元のクライアントではなくリモートホスト側に入れます。
JetBrainsで編集を自動承認するときの注意
acceptEditsとauto modeは、作業ディレクトリ内の編集を確認なしで通します- IDEが自動で実行する設定ファイルも書き換えられるため、Bashの許可確認をすり抜けることがあります
- 編集はManualモードで確認しながら進めると、この経路を閉じられます
JetBrainsプラグインを入れたIDEでも、計画へのコメントやタブの並行のような画面操作はVS Code拡張だけのものです。
Claude CodeのVS Code拡張の基本操作
パネルを開く入口は4つあります。最速はエディタ右上のSparkアイコンですが、ファイルを開いているときしか出ません。左のアクティビティバーのSparkアイコン(セッション一覧)、コマンドパレットの「Claude Code」、右下ステータスバーの「✻ Claude Code」は、ファイルを開いていなくても使えます。
Claude Codeパネルのプロンプト欄(模式図)
@src/auth.tsのログイン処理でトークンの期限切れを扱っていない箇所を直して
プロンプト欄
コンテキストの使用量と、プロンプトキャッシュの残り時間
番号1のプロンプト欄で/を打つとコマンドメニュー、@を打つとファイルの候補が開きます。番号2のモード表示で許可モードを、番号3のモデル名でモデルと思考の深さ(effort)を切り替えます。
ファイルを@メンションで渡す
@に続けてファイル名やフォルダ名を打つと、Claudeがその中身を読んだうえで答えます。あいまい一致なので、部分的な名前でも候補に出ます。フォルダは@src/components/のように末尾にスラッシュを付けます。
エディタで行を選んでOption+K(Mac)/ Alt+K(Windows/Linux)を押すと、@app.ts#5-10のような行番号付きの参照が入ります。統合ターミナルの出力は@terminal:名前で渡せます。ファイルはShiftを押しながらプロンプト欄へドラッグすると添付できます。ここに挙げた以外の指定が必要なときは、@メンションでファイル・フォルダを参照する方法を当たります。
選択範囲と開いているファイルは、何もしなくても自動でメッセージに入ります。送りたくない場合は、VS Code設定で2つのスイッチをオフにします。選択範囲はclaudeCode.attachSelection(v2.1.300以降)、開いているファイルはclaudeCode.attachOpenFile(v2.1.271以降)です。既定の設定では、.gitignoreの対象やfiles.excludeに当たるファイルで選んだ行の中身は、パネルから送られません。
許可モードを選ぶ
許可モードは、Claudeが編集やコマンドの前に確認を取るかどうかを決めます。プロンプト欄の下のモード表示を押して切り替えます。
| 画面の表示 | 設定値 | 動き方 |
|---|---|---|
| Auto | 設定値auto | 動き方分類器がほとんどの操作を審査し、確認の代わりにする |
| Manual | 設定値default(別名manual) | 動き方ファイル編集とほとんどのシェルコマンドの前に確認する |
| Plan | 設定値plan | 動き方何をするか説明し、承認されるまで変更しない |
| Edit automatically | 設定値acceptEdits | 動き方確認なしで編集する |
v2.1.284以降(公式ドキュメントのVS Codeページではv2.1.283と記載)は、auto modeが使える環境なら、何も設定しないとAutoで始まります。例外として、プロセスラッパー(claudeCode.claudeProcessWrapper)を設定しているとManualで始まります。Bypass permissionsは、拡張設定の「Allow dangerously skip permissions」を有効にしたときだけ選択肢に出ます。インターネットにつながらないサンドボックスでの利用を想定した設定です。
新しい会話の開始モードを固定するには、VS Codeのユーザー設定にclaudeCode.initialPermissionModeを書きます。この設定はautoを受け付けません。Autoで始めたいときは設定を空にし、モード表示でAutoを一度選びます。ワークスペース側の値は読まれないので、プロジェクトの設定に書いても効きません。それでもinitialPermissionModeが効かないときは、書いた場所と値を見直します。
Planモードの計画は、Markdown文書として自動で開きます。行にコメントを付けてから着手させられるのが、ターミナル版にない点です。/planで切り替え、/plan 認証のバグを直してのように続けると、その作業の計画から始めます(v2.1.280以降)。
差分を見て受け入れる
Manualモードでは、Claudeがファイルを編集する前に元のコードと編集案を並べて表示します。受け入れ・却下・別の指示から選べます。受け入れる前に差分ビューで編集案を直すと、直したことがClaudeに伝わります。AutoとEdit automaticallyでは、作業フォルダ内のほとんどのファイルを確認なしで編集します。
v2.1.275以降は、差分の変更ごとに「Accept this change」「Reject this change」のボタンが付きます。却下した変更だけが編集案から取り除かれます。変更が100か所を超える差分にはこのボタンが出ないので、ファイル単位でまとめて判断します。
編集のやり直しにはチェックポイントを使います。メッセージにマウスを乗せると巻き戻しボタンが出て、次の3つから選べます。
- Fork conversation from here: コードはそのままで、この時点から会話を分岐する
- Rewind code to here: 会話は残し、ファイルの変更だけこの時点に戻す
- Fork conversation and rewind code: 会話を分岐し、ファイルも戻す
Bashで消したファイルなど、チェックポイントで戻せない変更もあります。
会話の履歴とWeb版のセッション
パネル上部の「Session history」から、過去の会話をキーワードや日時で探して再開できます。14日間動きのないセッションは、自動で「Archived sessions」に移ります(v2.1.265以降。期間は設定で変更できる)。複数のタブやウィンドウで会話を並べる使い方もあります。
履歴ダイアログには「Local」と「Web」の2つのタブがあります。Webタブには、claude.aiで動かしたクラウドセッションとRemote Controlのセッションが並びます。使うにはClaude.aiサブスクリプションでのサインインが要り、Consoleアカウントでは使えません。開いているフォルダがGitHubリポジトリなら、そのリポジトリのセッションだけが表示されます。
落とし穴
Webから続けた会話はclaude.aiに戻らない
クラウドセッションを再開すると、拡張は会話履歴のコピーをダウンロードします。手元で続けた会話やコードの変更は、claude.ai側には同期されません。WebとVS Codeを行き来しながら1つのセッションを育てる使い方はできないので、どちらで続けるかを先に決めておきます。
使用量は/usageで開く「Account & usage」ダイアログで見られます。claude.aiのプランなら、セッション枠と週の枠の消費と、リセットまでの時間が出ます。数字はこのマシンのセッションから計算した概算で、他の端末やclaude.aiでの利用は含まれません。
VS Code拡張で広げられる作業
基本の頼む・見る・受け入れるの外にも、パネルから操作できることがあります。どれもCLIと同じ仕組みの上にあり、設定は共有されます。
パネルから使える周辺機能
プラグインの管理
/pluginsで管理画面が開きます。入れるときは、自分の全プロジェクト(Install for you)・共同作業者と共有するこのプロジェクト(Install for this project)・自分だけ、このリポジトリだけ(Install locally)の3つから選びます。MCPサーバーの追加
/mcpのダイアログで、サーバーの追加・削除・有効化・OAuth認証を扱えます。追加と削除はv2.1.261以降です。Chromeの操作
@browserに続けて指示すると、ChromeでWebアプリの確認やコンソールの確認ができます。Claude in Chrome拡張の1.0.36以降が必要です。バックグラウンド実行
長いコマンドやサブエージェントの下にある「Run in background」で裏に回せます(v2.1.287以降)。進み具合は
/tasksで見ます。
同僚にも同じプラグインを入れてほしいときは、導入リンクを配る方法が使えます。MCP実用ガイドで選んだサーバーは、統合ターミナルのclaude mcp addで追加しても同じ設定に保存されます。
ターミナルのCLIとVS Code拡張を行き来する
拡張とCLIは、同じClaude Codeの別の画面です。会話履歴・~/.claude/settings.jsonの設定・プラグインは両方で共有されます。CLIにしかない機能が要るときだけ、統合ターミナルに降ります。
| 機能 | CLI | VS Code拡張 |
|---|---|---|
| コマンドとスキル | CLIすべて | VS Code拡張一部(/で一覧が出る) |
| MCPサーバーの設定 | CLIできる | VS Code拡張できる(/mcpで追加・管理) |
| チェックポイント | CLI対応 | VS Code拡張対応 |
!でのBash実行 | CLI対応 | VS Code拡張非対応 |
| タブ補完 | CLI対応 | VS Code拡張非対応 |
拡張を入れたのに claude が見つからない
- 後輩
VS Code拡張を入れたので、統合ターミナルで
claudeと打ったら「command not found」でした。壊れてますか? - 先輩
壊れていないよ。拡張が持っているCLIはチャットパネル専用のコピーで、PATHには入らないんだ。
- 後輩
じゃあ、ターミナルでも使いたいなら?
- 先輩
CLIを別にインストールするんだ。一度入れれば、
claude --resumeもclaude mcp addも、どのターミナルでも動くよ。
CLIはmacOS / Linux / WSLなら次のコマンドで入ります。WindowsのPowerShellではirm https://claude.ai/install.ps1 | iexを使います。OS別のインストール手順を見ると、HomebrewやWinGetで入れたときの更新の違いも分かります。
curl -fsSL https://claude.ai/install.sh | bash統合ターミナル(Ctrl+` / Cmd+`)でclaudeを実行すると、差分表示や診断の共有といったIDE連携が自動で有効になります。VS Codeの外のターミナルからつなぐ場合は、Claude Codeの中で/ideを実行します。拡張が動いている間は、CLIが接続するideという名前のローカルMCPサーバーが立ち上がっています。
拡張で始めた会話をCLIで続けるには、ターミナルで次を実行し、出てきた一覧から選びます。
claude --resume落とし穴
同じ会話を2か所で開くと「still open somewhere else」と出る
ターミナルのclaudeと拡張の両方で同じ会話を開くと、プロンプト欄の代わりに次の通知が出ます。「This conversation is still open somewhere else」。2か所で同時に使うとメッセージが混ざるためです。先に片方を閉じてから「Open here anyway」を押します。拡張の再起動直後で他に何も開いていない場合は、前のプロセスが残っています。たいてい10分ほどで終わるので、待ってから押します。
Claude Code VS Code拡張の設定とショートカット
設定の置き場所は2つあります。VS Code側の拡張設定(Cmd+, / Ctrl+, → Extensions → Claude Code)は、拡張の見た目と動きを決めます。許可ルール・環境変数・hooks・MCPサーバーは~/.claude/settings.jsonに書き、CLIと共有します。
| 操作 | Mac | Windows/Linux |
|---|---|---|
| エディタとClaudeのフォーカス切替 | MacCmd+Esc | Windows/LinuxCtrl+Esc |
| 新しいタブで会話を開く | MacCmd+Shift+Esc | Windows/LinuxCtrl+Shift+Esc |
| @メンション参照を挿入 | MacOption+K | Windows/LinuxAlt+K |
| 閉じたセッションタブを開き直す | MacCmd+Shift+T | Windows/LinuxCtrl+Shift+T |
| Focus viewの切り替え | MacCtrl+Option+F | Windows/LinuxCtrl+Alt+F |
Cmd+N / Ctrl+Nで新しい会話を始めるショートカットは、既定ではオフです。使うにはenableNewConversationShortcutをtrueにします。
Focus view(v2.1.221以降)は、ツールの呼び出しと思考を折りたたみ、プロンプトと返答だけを表示します。
よく触る拡張設定(主なもの)
| 設定 | 既定値 | 内容 |
|---|---|---|
useTerminal | 既定値false | 内容チャットパネルの代わりにターミナルモードで開く |
initialPermissionMode | 既定値未設定 | 内容新しい会話の開始モードを固定する(autoは不可) |
preferredLocation | 既定値panel | 内容開く場所。sidebar(右)かpanel(新しいタブ) |
autosave | 既定値true | 内容Claudeが読み書きする前にファイルを保存する |
respectGitIgnore | 既定値true | 内容.gitignoreの対象をファイル検索と選択範囲の送信から外す |
拡張の設定は全部で20項目を超えます。各項目の意味とsettings.json側との分担を押さえると、どこに書くか迷いません。許可ルールやhooksを書く~/.claude/settings.jsonは、書き方の全体像から入れます。
Claude CodeのVS Code拡張でつまずいたときの切り分け
詰まりやすいのは「拡張が出ない」「サインインが通らない」「返事が来ない」の3つです。拡張が出ないときは、上から順に確かめます。
Sparkアイコンが出ないときの確かめ方
- Qエディタでファイルを開いている?答えがいいえのとき答えがはい
右上のSparkアイコンは、フォルダを開いただけでは出ません。ファイルを1つ開くか、右下ステータスバーの「✻ Claude Code」から開きます。
- QVS Codeは1.94.0以上?答えがいいえのとき答えがはい
Help → Aboutで確かめ、古ければVS Codeを更新します。
- Qワークスペースは信頼済み?答えが制限モード答えがはい
拡張はRestricted Mode(制限モード)では動きません。ワークスペースを信頼してから開き直します。
- QClineやContinueなど他のAI拡張を止めても出ない?答えが止めたら出た答えがはい
他のAI拡張との競合です。一時的に無効にして使い分けます。
Developer: Reload Window
ここまで当てはまらなければ、コマンドパレットからウィンドウを再読み込みします。パネルが真っ白なままなら、拡張をv2.1.309以降に更新してから再読み込みします。
サインインを何度も求められるときは、まず起動のしかたを疑います。シェルにANTHROPIC_API_KEYを設定しているのにサインイン画面が出る場合、VS Codeがシェルの環境変数を引き継いでいません。ターミナルからcode .でVS Codeを起動すると引き継がれます。「Not logged in · Please run /login」と出たときは、サインイン画面が自動で出直すのを待ち、出なければウィンドウを再読み込みします。サインインし直したいときは、ログアウトしてからやり直します。
落とし穴
macOSでCmd+Escを押しても何も起きない
macOS Tahoe以降は、システムのゲームオーバーレイがCmd+Escを先に受け取ります。システム設定 → キーボード → キーボードショートカット → ゲームコントローラーで、ゲームオーバーレイのチェックを外します。VS Codeのキーボードショートカットエディタで「Claude Code: Focus input」に別のキーを割り当てる方法もあります。
落とし穴
アンインストールした拡張が勝手に戻ってくる
VS Codeの統合ターミナルでclaudeを実行すると、Claude Codeが拡張を自動で入れ直します。外したままにするには、/configで「Auto-install IDE extension」をオフにするか、設定のautoInstallIdeExtensionをfalseにします。環境変数CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1でも止められます。
API Error: 403 Request not allowedのようなエラー文は、起動・認証のトラブルとして症状別に当たれます。サインインできているのに返事が来ないときは、原因を絞る手順が別にあります。
拡張機能そのものを自作する側に回りたくなったら、雛形から公開までの流れを先に見ておけます。
まとめ
VS Code拡張とCLIは対立する選択肢ではありません。ふだんはパネルでManualモードの差分を見ながら進め、!やタブ補完が要る場面でだけ統合ターミナルに降りる形が、両方の強みを生かせます。そのためにCLIは最初から一緒に入れておくと、PATHのつまずきを踏まずに済みます。Claude Code全体のコマンド体系をつかみたい場合はClaude Codeの基礎ガイドが次の入口になります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。