この記事の目次
Claude Code VSCode拡張とは？CLI版との違い
Claude Code VSCode拡張は、ターミナルで動くClaude Code CLIと同じ実行エンジンをVS Codeのパネル内から操作できるようにした、薄いラッパーである。両者は別のツールではなく、同じセッションを別の入り口から使っているに近い。
拡張機能をインストールすると、エディタのサイドバーにClaude Codeのパネルが追加され、コードを選択したままAIとやり取りできるようになる。提案されたコードはターミナル出力ではなく、通常の差分表示（変更前後を色分けして見せる画面）としてエディタ内に表示される点がCLI版と異なる。この差分表示と、ファイルを開いたまま質問できる操作感が、拡張版の主な価値である。
一方で、認証方式や課金体系、Claude自体の思考能力は共通で、拡張版だけの特別な機能や制限があるわけではない。「何が違うのか」を一言でまとめると、実行エンジンは同じで、操作の窓口（ターミナルかエディタ内パネルか）が違う、ということになる。Claude Code自体の全体像を先に知りたい場合はClaude Codeとは何か、CLI版を含めた日常的な使い方はClaude Codeの使い方ガイドを参照すると理解が早い。
インストールとサインインの手順
拡張版のインストールは、VS Codeの拡張機能マーケットプレイスから「Claude Code」を検索して追加するだけで完了し、追加のビルド作業は不要である。
手順は次の通りである。まずVS Code左側の拡張機能アイコンから「Claude Code」を検索し、公式のものをインストールする。次に画面の案内に従ってAnthropicアカウントでサインインする。CLI版と同様にAPIキーの手動入力は不要で、対応する有料プランに加入していればサインインだけで利用できる。プラン別の対応範囲まで踏み込むと長くなるため、比較はClaude Codeの料金ガイドに譲る。
インストール直後は、サイドバーにパネルが表示されているか、サインイン後にプロジェクトのフォルダを認識できているかの2点をまず確認するとよい。表示されない場合の対処は後述のチェックリストで扱う。
拡張機能で日常的にできること（基本操作）
拡張版で日常的にできることは、ファイルを指定して質問する、提案された差分を確認して承認する、実行前に計画を確認する、という3つの操作にほぼ集約される。
1つ目は@メンションによるファイル参照である。チャット欄で@に続けてファイル名を入力すると、そのファイルの内容を文脈として渡せる。開いているファイル全体だけでなく、選択した範囲だけを渡すことも可能で、大きなファイルの一部だけを議論したいときに有効である。プロジェクトの前提知識をあらかじめまとめて渡しておきたい場合は、CLAUDE.mdの書き方ガイドを使う方法もある。
2つ目は差分の確認と承認である。Claudeがコード変更を提案すると、変更前後が並んで表示され、そのまま適用するか、修正を依頼するか、却下するかを選べる。ここで一括承認してしまうと意図しない変更まで反映される場合があるため、変更点が複数にまたがるときは1つずつ確認する習慣をつけておくと安全である。
3つ目はPlan modeで、コードを実際に書き換える前に変更方針だけを提示させるモードである。モードごとの使い分けは次の権限モードの節で詳しく扱う。
権限モードの選び方
権限モードは、Claudeがコードを変更するたびに人間の承認を求めるか、ある程度自動で進めさせるかを決める設定で、初めて使う場合はManualモードから始めるのが無難である。
主なモードはManual、Plan、Auto-Acceptの3つである。Manualは変更のたびに承認を求めるモードで、初学者やまだプロジェクトの構造に慣れていない段階では、1つずつ差分を確認しながら進めた方が意図しない変更に気づきやすい。Planは、コードを実際に書き換える前に「何をどう変更するつもりか」という計画だけを提示させるモードで、複雑な変更を依頼するときほど、先に計画を確認してから実行に移すと手戻りが少ない。Auto-Acceptは一定範囲の変更を自動で承認するモードである。
自動承認の範囲を広げてよいのは、変更対象のファイルが限定的で、かつテストやビルドで結果をすぐ検証できる環境が整っている場合である。逆に、本番環境に近いブランチや、影響範囲が読みにくい大規模な変更では、モードを緩めない方が安全に運用できる。こうした判断を個人の裁量に留めず、チームの運用ルールとして明文化する方法はClaude Codeの運用ルールにまとめている。
便利な設定・ショートカットの調整ポイント
拡張版を使い始めた段階でまず調整する価値があるのは、チャットパネルの呼び出しショートカットと、差分の承認・却下に使うショートカットの2種類である。
VS Code本体のショートカットと同様、Claude Codeパネルの各操作にもキーボードショートカットが割り当てられており、コマンドパレット（Cmd/Ctrl + Shift + P）から「Claude Code」と検索すると一覧を確認できる。頻繁に使うのはパネルを開閉するショートカット、差分を承認するショートカット、次の提案へ移動するショートカットなどいくつかで、それ以外は必要になったときにコマンドパレットから探す形で十分である。
settings.jsonでは、パネルの表示位置や、差分表示の見た目に関する設定を調整できる。設定項目を全て覚える必要はなく、まずはデフォルトのまま使ってみて、作業の妨げになる部分だけを個別に変更していく進め方で困らない。
CLI版と拡張版、どちらを使うべきか
作業スタイルで選ぶなら、エディタから離れずにコードを書きながら都度確認したい場合は拡張版、複数ファイルを横断してレビューしたり、CI/CDやスクリプトと組み合わせて使いたい場合はCLI版が向いている。なお、CursorなどほかのAIコーディングツールとの比較まで検討している場合はClaude CodeとCursorの比較で扱っているため、ここではCLI版と拡張版という同一プロダクト内の比較に絞る。
| 比較軸 | CLI版が向く場面 | 拡張版が向く場面 |
|---|---|---|
| 作業の単位 | 複数ファイル・複数リポジトリを横断する作業 | 今開いているファイル中心の作業 |
| 実行環境との連携 | スクリプトやCI/CDへの組み込み | エディタ内で完結させたい作業 |
| 確認のタイミング | まとめて差分を確認したい | コードを書きながら都度確認したい |
| 学習コスト | ターミナル操作に慣れが必要 | VS Codeの操作感のまま使える |
どちらか一方に決め切る必要はなく、普段のコーディングは拡張版、大きめのリファクタリングやスクリプト連携が必要な場面はCLI版、というように併用する選択肢も現実的である。
なお、SSHやWSL、Dev Containersなどのリモート開発環境や、モノレポ・マルチルートワークスペースでの拡張版の挙動については、本記事執筆時点で一次情報による裏付けが十分に取れていない。こうした構成で使う予定がある場合は、断定的な情報を鵜呑みにせず、公式ドキュメントで対応状況を確認してから判断することを勧める。
つまずいたときの確認チェックリスト
拡張機能が反応しない、サインインが通らないといったトラブルの多くは、原因を一つに断定するより、次のチェック項目を順に確認していく方が解決に近づきやすい。
拡張機能が表示されない、または反応しない場合の確認項目は次の通りである。
- VS Codeを再起動し、拡張機能を再読み込みしているか
- Claude Code拡張機能が最新バージョンに更新されているか
- 他の拡張機能と競合していないか、一時的に無効化して試したか
- VS Code本体のバージョンが拡張機能の対応バージョンを満たしているか
サインインでつまずいた場合の確認項目は次の通りである。
- Anthropicアカウントで対応プランに加入した状態になっているか
- ブラウザ側の認証フローが正常に完了し、VS Codeに戻ってきているか
- 社内ネットワークやVPNの設定が認証通信をブロックしていないか
- 一度サインアウトしてから再度サインインし直しても症状が変わらないか
非エンジニアの場合は用語の壁でこの確認自体が難しく感じられることもあるため、先に非エンジニアがClaude Codeで陥りやすい壁を読んでおくと迂回できるつまずきもある。それでも解決しない場合は、環境変数の継承やネットワーク設定など、個別環境に依存する要因が絡んでいる可能性がある。
チーム展開を考え始めたら見るべきポイント
個人利用の範囲を越えて法人・企業でチーム展開を検討し始めた段階では、拡張機能単体の設定だけでなく、MCPサーバー連携の扱いや権限ルールの設計といった、組織としての判断が必要になる。
拡張版にはIDE内蔵のMCPサーバー（Claudeが外部ツールやデータソースと連携するための仕組み）が組み込まれており、個人利用では意識しなくても動作するが、チームで使う場合はどの範囲の連携を許可するかを事前に決めておく必要がある（ガバナンス設計まで含めた仕様はClaude CodeのMCP運用ガイドに委ねる）。
同様に、誰がどの権限モードをデフォルトにするか、承認履歴をどう残すかといった運用ルールも、個人利用の段階では意識せずに済んでいた論点である。権限モードの節で触れた運用ルールの明文化は、チーム展開の場面でより重要度が増す。
まとめ：個人利用の次のステップ
ここまでの内容を一通り試せば、VS Code拡張版のインストールから、@メンション・差分承認・権限モードの基本操作、そしてCLI版との使い分けまで、自分の言葉で説明できる状態になっているはずである。
個人での利用に関しては、これで一区切りついたと考えてよい。次に出てくる課題は、チームや組織で使い始めたときの権限設計や監査、そしてメンバーへの研修設計といった、個人利用の延長線上にはない論点である。もしチームで展開する前に判断軸や研修内容を整理しておきたい場合は、Claude Codeの研修選びガイドで比較の視点を確認できる。この先の使い方をまとめて追いたい場合は、月額1,980円からの学習コミュニティAI駆動ラボに講座がまとまっている。
無理に急ぐ必要はなく、個人での使い込みが十分に進んでから、組織展開の検討に移るという順番で構わない。