インサイトトップ/記事一覧/Claude CodeをVS Codeで使う方法——拡張機能の入れ方とCLIとの使い分け

SHARE

Claude CodeをVS Codeで使う方法——拡張機能の入れ方とCLIとの使い分け

Claude CodeをVS Codeで使う方法——拡張機能の入れ方とCLIとの使い分け

下岡 稔
2026.11.16

VS CodeでClaude Codeを使えるのか、CLIとどう使い分けるのか迷っていませんか。公式の拡張機能から使え、画面で差分を確認しながら進められます。Claude Code自体の説明はClaude Codeとは——コードだけじゃない「AI業務エージェント」を参照してください。導入手順とCLIとの使い分け、Cursorでの扱い、チームで決める注意点を2026年11月時点の情報で解説します。

Claude CodeをVS Codeで使うとは:公式拡張機能の位置づけと前提条件

公式拡張機能「Claude Code for VS Code」とは

Claude Code for VS Codeは、Anthropicが公開しているVS Code向けの拡張機能です。公式ドキュメントは、VS CodeでClaude Codeを使う推奨の方法と位置づけています。

プランの確認と編集、編集の自動承認、選択範囲を行番号つきで@メンションする操作、会話履歴の参照、複数の会話のタブ・ウィンドウでの並行利用に対応します。

必要なVS Codeとアカウント

2026年11月時点の対応VS Codeは1.94.0以降です。アカウントは有料のClaudeサブスクリプション(Pro・Max・Ultra・Team・Enterprise。Freeは対象外)かConsoleで、APIキーは不要です。

Consoleは2.1.242以降ならAPIキーなしでサインインできます。

料金はClaude Codeの料金——無料枠の有無とプラン比較・法人の見積例を解説で解説しています。

動作環境の考え方

動作要件は、macOS 13.0以降、Windows 10 1809以降またはWindows Server 2019以降、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降です。メモリは4GB以上、プロセッサーはx64かARM64です。

2026年11月時点のMarketplaceには、win32-x64やdarwin-arm64など8種類のパッケージが並びます。

出典:Claude Code Docs「Use Claude Code in VS Code」(Overview/Prerequisites)

出典:Claude Code Docs「Authentication」(Sign in without an API key)

出典:Claude Code Docs「Advanced setup」(System requirements)

出典:Claude「Pricing」(Compare features across plans:Claude Code行)

出典:Visual Studio Marketplace「Claude Code for VS Code」(配布パッケージ)

拡張機能の入れ方:インストールからサインインまで

拡張機能のインストール、パネルを開いてサインイン、設定の確認という3ステップを示した図

Marketplaceからインストールする

Visual Studio MarketplaceのClaude Code for VS Code拡張機能ページの画面(2026年11月16日時点)

出典:Visual Studio Marketplace「Claude Code for VS Code」

拡張機能の識別子はanthropic.claude-codeです。公式ドキュメントのインストールリンク(vscode:extension/anthropic.claude-code)か、Visual Studio Marketplaceの拡張機能ページから追加します。

パネルを開いてサインインする

エディタ右上のツールバーにあるSparkアイコンをクリックすると、パネルが開きます。ファイルを開いていないとこのアイコンは出ないため、その場合はウィンドウ右下のステータスバーにある「✻ Claude Code」が入口です。

初回はサインイン画面が出るので、Sign inを押してブラウザで認可を完了すれば、サインインは終わりです。

最初に確認しておきたい設定

起動する形式、開く場所、ファイルの自動保存は、VS Codeの拡張機能設定で決められます。

設定名 既定値 内容
useTerminal false グラフィカルなパネルではなく、ターミナルモードでClaudeを起動する
preferredLocation panel Claudeを開く場所。sidebar(右側)かpanel(新しいタブ)
autosave true Claudeがファイルを読み書きする前に、自動保存する

出典:Claude Code Docs「Use Claude Code in VS Code」(Install the extension)

出典:Claude Code Docs「Use Claude Code in VS Code」(Get started:Step 1・2)

出典:Claude Code Docs「Use Claude Code in VS Code」(Configure settings:Extension settings)

VS Codeで何ができるか:差分・@メンション・プラン確認

@メンションと選択範囲で対象を指定する

エディタで選択したテキストは、Claudeに自動で見える状態になります。Alt+K(MacではOption+K)を押すと、ファイルのパスと行番号を含む@メンション(例:@app.ts#5-10)が入ります。

選択がなくても、開いているファイルはClaudeから見える状態です。Attach Open Fileの設定を切ると、添付は選択テキストだけになります(Claude Code 2.1.271以降)。

差分を見ながら変更を承認する

Manualモードでは、Claudeがファイルを編集しようとすると、元の内容と提案を並べた比較diffが表示され、続けて許可を求められます。diff内で提案の内容を直接編集してから承認すると、その修正がClaudeにも伝わります。

変更を1つずつ承認・拒否するボタンは2.1.275以降の機能です。変更が100件を超えるdiffはボタンなしで開き、ファイル全体で確認する形になります。

プランモードとチェックポイントで途中から戻す

プランモードでは、Claudeが内容を説明し、承認後に変更します。プランはMarkdown文書として開き、インラインコメントで修正を返せる仕様です。

/planで切り替えられ(2.1.280以降)、プランモード中の/plan openでプランファイルを開けます。

巻き戻しの選択肢 動作
Fork conversation from here その時点から新しい会話を分岐する。コードの変更はそのまま残る
Rewind code to here ファイルの変更をその時点まで戻す。会話履歴は全て残る
Fork conversation and rewind code 新しい会話を分岐し、ファイルの変更もその時点まで戻す

Bashコマンドだけで変更したファイルは、巻き戻しの対象外です。 Claudeが編集ツールで一度編集したファイルなら、その後にBashコマンドで加えた変更も巻き戻せます。

会話の再開と並行作業

パネル上部の「Session history」から、過去の会話を検索か時間順でたどれます。コマンドパレットの「Open in New Tab」「Open in New Window」で、別の会話を並行して開けます。

履歴とコンテキストは会話ごとに別です。リロード後のサイドバーには、直近10分以内にメッセージを送ったかClaudeが応答した会話が戻ります。

出典:Claude Code Docs「Use Claude Code in VS Code」(Reference files and folders)

出典:Claude Code Docs「Use Claude Code in VS Code」(Get started:Step 4 Review changes)

出典:Claude Code Docs「Use Claude Code in VS Code」(Use the prompt box:Permission modes/Resume past conversations)

出典:Claude Code Docs「Checkpointing」(Limitations:Bash command changes not tracked)

拡張機能とCLIの使い分け:機能の違いと選び方

CLI専用の機能が要るか、画面でレビューもしたいかの2つの問いで、拡張機能とCLIのどちらを使うか選ぶ判断フロー図

基本操作はClaude Codeの使い方——インストールから基本操作・つまずき対処を解説にまとめています。

機能比較表で見る違い

機能 CLI VS Code拡張機能
コマンドとスキル すべて 一部(/で利用できるものを確認)
MCPサーバー設定 可 可(チャットパネルの/mcpで追加・管理)
チェックポイント 可 可
! Bashショートカット 可 不可
タブ補完 可 不可

スクリプト実行とAgent SDKは、CLIだけで使えます。

統合ターミナルでCLIを使う条件

拡張機能が同梱するCLIは、チャットパネル用の別のコピーです。拡張機能を入れてもclaudeコマンドはPATHに追加されないため、統合ターミナルで実行するには単体のCLIを別にインストールします。

拡張機能を入れたVS Codeの統合ターミナルなら、CLIはIDEと自動で連携し、diff表示やProblemsパネルのエラー・警告の共有も使える状態です。Claude Code 2.1.318以降のCLIは拡張機能を自動では入れないため、先に拡張機能をインストールしておきます。外部ターミナルでは、Claude Code内で/ideを実行してVS Codeに接続します。

出典:Claude Code Docs「Use Claude Code in VS Code」(VS Code extension vs. Claude Code CLI)

出典:Claude Code Docs「Platforms and integrations」(CLIの説明段落)

出典:Claude Code Docs「Use Claude Code in VS Code」(Prerequisites/Run CLI in VS Code)

出典:Claude Code Docs「Commands」(/ide)

Cursorなど他のVS Code系エディタで使う場合

VS CodeとCursorそれぞれでのClaude Code拡張機能の入れ方と、Cursor標準のAI機能(Agent・Tab)を並べて整理した図

Cursorに拡張機能を入れる

公式ドキュメントには、VS Code用の「Install for VS Code」と並んで、Cursor用の「Install for Cursor」リンク(cursor:extension/anthropic.claude-code)があります。拡張機能はDevin DesktopやKiroなど、ほかのVS Code系エディタにもインストールでき、エディタの拡張機能ビューで「Claude Code」を検索するか、Open VSXレジストリから入れます。

Cursor標準のAI機能(Agent・Tab)とClaude Codeを並べて見る

Cursor公式ドキュメントの説明では、Agentは複雑なコーディングタスクを自律的にこなし、ターミナルコマンドの実行とコードの編集もするアシスタントです。Tabは、直近の編集と周辺コード、リンターエラーをもとに入力中に候補を出す、AI駆動のオートコンプリート。

Claude Codeの拡張機能はAnthropicが提供する別の製品で、Cursor標準のAgentやTabとは別の機能です。

拡張機能を入れられないときはCLIを使う

エディタに拡張機能をインストールできないときは、CLIをインストールして使います。CLIは、任意のターミナルで動きます。

出典:Claude Code Docs「Use Claude Code in VS Code」(Install the extension:Cursor・VS Code系エディタ)

出典:Cursor Docs「Agent Overview」

出典:Cursor Docs「Tab Overview」

開発チームで使うときの決めごと:権限・承認・設定の共有

チームで決める4つの軸として、権限モード、設定の置き場所、機密ファイル、バージョンを示した図

権限モードをチームでどう決めるか

VS Codeで選べる権限モードは次の4つです。

モード 動作
Auto 確認の代わりに、分類器がほとんどの操作を審査する
Manual ファイル編集とほとんどのシェルコマンドの前に許可を求める
Plan 前述のプランモード
Edit automatically 確認なしで編集する

Claude Code 2.1.283以降の既定はAutoです。 設定でAutoを無効にした場合や非対応のモデルでは、Manualで始まります。標準のモードは、チームで先に決めておくのが確実です。

設定とルールをどこに置いて共有するか

~/.claude/settings.jsonに書いたClaude Codeの設定は、拡張機能とCLIで共有されます。 許可するコマンド、環境変数、フック、MCPサーバーを置く場所です。

指示の書き方は、CLAUDE.mdとは?書き方・置き場所・ベストプラクティスを解説で解説しています。

機密ファイルと自動編集のリスクに備える

ワークスペース内で除外設定(files.excludeなど)に一致するファイルの場合、パネルから送られるのは選択テキストでなく最大でもパスです。統合ターミナルのCLIは選択テキストを送るので、Readの拒否ルールで防ぎます。

VS Codeの設定ファイル(settings.json・tasks.json)が入る.vscodeフォルダは保護対象のパスで、Edit automaticallyでも書き込み前に確認が出ます。Autoでは分類器が可否を判断するため、扱いをチームで決めておきます。会社でAIを使う前に——情報漏洩と学習、2つのリスクへの対応とはもあわせてご覧ください。

バージョンをそろえる

拡張機能のバージョン番号は、同梱するClaude Codeのバージョンと同じです。ある機能が2.1.286以降を求めるなら、拡張機能も2.1.286以降にそろえます。

機能の可否がメンバーで食い違うときは、まず各自のバージョンを見比べます。 2026年11月時点の最新版は2.1.325(2026年11月13日リリース)です。個人が拡張機能を入れる手順と、チームで標準を設計する作業は別の仕事です。

出典:Claude Code Docs「Use Claude Code in VS Code」(Use the prompt box:Permission modes)

出典:Claude Code Docs「Permission modes」(Available modes/Which mode a session starts in)

出典:Claude Code Docs「Use Claude Code in VS Code」(Configure settings:Claude Code settings)

出典:Claude Code Docs「Use Claude Code in VS Code」(Selected text from excluded or ignored files)

出典:Claude Code Docs「Permission modes」(Protected paths)

出典:Claude Code Changelog「2.1.325」(November 13, 2026)

うまく動かないときの確認ポイント

拡張機能やSparkアイコンが出ないときと、応答がないときの2つの症状ごとに確認項目を並べた切り分け図

拡張機能が表示されない・Sparkアイコンが出ない

表示されないときは、VS Codeの再起動かコマンドパレットの「Developer: Reload Window」を実行します。Sparkアイコンが出ないなら、ファイルを開いているか(フォルダだけは不可)、ClineやContinueなど他のAI拡張を一時無効にしたか、VS Codeの版が前述の条件に合うかを確認します。

Restricted Modeでは動作しないため、ワークスペースの信頼も確認項目です。

応答がないときの確認手順

応答がないときは、まずインターネット接続が安定しているかを確認し、新しい会話を始めて症状が続くかを見ます。ターミナルでのclaudeの実行も、詳しいエラーを確認する手段です。

それでも解決しない場合は、GitHubでIssueを報告します。

出典:Claude Code Docs「Use Claude Code in VS Code」(Fix common issues:Extension won’t install/Spark icon not visible)

出典:Claude Code Docs「Use Claude Code in VS Code」(Fix common issues:Claude Code never responds)

Claude Code × VS Codeについてよくある質問

Q1. しばらく操作していない会話は消えますか?

既定では、14日間操作のない会話は「Archived sessions」へ移ります。 開いている・未読・グループ内の会話は対象外です。期間は1・2・7・14日から選べ、Neverで無効にもできます(2.1.265以降)。

巻き戻しのスナップショットはセッション内の直近100チェックポイント分を保持し、既定では最後の保存から約30日で削除されます。期間はcleanupPeriodDaysで延長が可能です。

出典:Claude Code Docs「Use Claude Code in VS Code」(Resume past conversations/Extension settings)

出典:Claude Code Docs「Checkpointing」(Limitations)

Q2. 入力したコードはモデルの学習に使われますか?

扱いはアカウントの種類しだいです。 Free・Pro・Max・Ultraでは、学習への利用を許可する設定がオンなら、Claude Codeの利用分も新しいモデルの学習に使われます。Team・Enterprise・APIなどの商用契約では、顧客がモデル改善への提供を選んだ場合を除き、Claude Codeに送ったコードやプロンプトで生成モデルを学習しないと公式に記載されています。

出典:Claude Code Docs「Data usage」(Data training policy)

Q3. Amazon Bedrockなどのクラウドプロバイダ経由でも使えますか?

Amazon BedrockやGoogle CloudのAgent Platformなど、第三者プロバイダ経由でClaudeを使う場合の案内は、公式ドキュメントの「Use third-party providers」にまとめられています。 認証できるアカウントの種類にも、Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryが挙がっています。

出典:Claude Code Docs「Use Claude Code in VS Code」(Prerequisites)

出典:Claude Code Docs「Authentication」(You can authenticate with any of these account types)

Q4. 使うモデルは途中で切り替えられますか?

はい。セッションの途中でも、コマンドメニューの「Switch model…」か、プロンプトボックス下部のモデル名のクリックで開くピッカーから切り替えられます。 /modelだけの入力でもピッカーが開きます(Claude Code 2.1.284以降)。

Effortの行は、モデルが対応しているときに表示され、モデル名ボタンとともに2.1.257以降の機能です。

出典:Claude Code Docs「Use Claude Code in VS Code」(Use the prompt box:Model)

Q5. ファイルをチャットに添付できますか?

ファイルは、Shiftキーを押しながらプロンプトボックスへドラッグすると添付できます。

出典:Claude Code Docs「Use Claude Code in VS Code」(Reference files and folders:ファイルの添付)

まとめ:VS Codeでは公式拡張機能から始め、CLI専用の機能が要る場面だけ併用する

VS Codeでは、公式拡張機能から始め、CLI専用の機能が要る場面だけ併用すれば十分です。拡張機能はインストールとサインインだけで使い始められ、差分の確認も画面で済みます。

拡張機能とCLIでは、使えるコマンドとスキルに差があります。チームで使う場合、権限モードと設定の置き場所は先に決める項目です。

まずは手元で拡張機能を試し、チームで使うなら決めごとを洗い出してみてください。

研修の内容は、パンハウスの生成AI研修で紹介しています。

Claude Codeを開発チームで使う体制づくり、一緒に始めませんか?パンハウスは、Claude Codeを日々の業務で使い倒しているAI開発会社です。開発組織向けに、Claude CodeとCodexを使う開発組織研修を用意しており、権限モードや設定の標準づくりからチームへの定着まで伴走します。まずはお気軽にご相談ください。詳しくはこちら