Claude Code VSCode拡張機能の使い方・設定を解説
Claude CodeをVS Codeで使いたいが、拡張機能のインストール方法や設定がよくわからない、という声をよく聞く。本記事では、Claude CodeのVS Code拡張機能のインストール手順・基本的な使い方・便利な設定・CLIとの違い・よくあるトラブルシューティングを、2026年11月時点の情報で解説する。日本語設定や承認モードの切り替えなど、使い始めに役立つ情報もあわせてまとめた。
Claude Code VS Code拡張機能とは
Claude Code VS Code拡張機能は、AnthropicのAIコーディングアシスタント「Claude Code」をVS Code(Visual Studio Code)のGUI上で操作できる公式拡張機能だ。サイドパネルやパネルにClaude Codeのチャット画面が統合され、コードの編集・生成・レビュー・デバッグをVS Codeを離れずに行える。
CLI版との違い
Claude Codeにはターミナルで操作するCLI(コマンドライン)版と、今回紹介するVS Code拡張機能版の2種類がある。主な違いを以下に整理する。
| 比較項目 | CLI版 | VS Code拡張機能版 |
|---|---|---|
| 起動方法 | ターミナルでclaudeコマンド | VS Code内でSparkアイコンをクリック |
| スラッシュコマンド | フルセット対応 | 一部のみ対応 |
| チェックポイント(操作の巻き戻し) | 対応済み | 追加予定(2026年11月時点) |
| MCP(外部ツール連携)設定 | 直接設定可能 | 間接的に対応 |
| GUI操作性 | テキストベース | 差分表示・クリック操作が可能 |
GUIで差分を確認しながら作業したい場合はVS Code拡張機能版が使いやすい。高度なカスタマイズや全スラッシュコマンドを使いたい場合はCLI版が向いている。Claude CodeとCodex(OpenAI)の違い・使い分けも参考にしてほしい。
対応プランと料金(2026年11月時点)
Claude Code VS Code拡張機能を使うには、Claude有料プランへの加入が必要だ。以下は2026年10月時点で確認された公式料金をもとにした一覧だ(本記事執筆時点で確認済み。最新情報はClaude公式料金ページで要確認)。
| プラン | 月額(USD) | 日本円目安 | Claude Code |
|---|---|---|---|
| Free | 無料 | 0円 | 利用不可 |
| Pro | $20/月 | 約3,000円 | ✓ 利用可 |
| Max(5x) | $100/月 | 約15,000円 | ✓ 利用可 |
| Max(20x) | $200/月 | 約30,000円 | ✓ 利用可 |
| Team Standard | $25/席・月(年払い$20) | 約3,750円〜 | ✓ 利用可 |
| Team Premium | $125/席・月(年払い$100) | 約18,750円〜 | ✓ 利用可 |
| Enterprise | カスタム | 要問い合わせ | ✓ 利用可 |
日本円目安は1USD=150円での換算。為替レートにより実際の支払額は変動する。個人で使い始める場合はProプラン($20/月)が最初のステップになる。
Claude Code VS Code拡張機能のインストール手順
インストールは数分で完了する。以下の手順に従って設定しよう。
事前に必要なもの
インストール前に以下を確認しておこう。
- VS Code バージョン 1.94 以上(公式サイトから無料でインストール可能)
- Claudeの有料プランアカウント(Pro以上。Freeプランでは利用不可)
- インターネット接続環境
インストール手順(4ステップ)
- 拡張機能ビューを開く:VS Codeを起動し、左サイドバーの四角いアイコン(拡張機能)をクリックするか、Ctrl+Shift+X(MacはCmd+Shift+X)を押す。
- 「Claude Code」を検索する:検索ボックスに「Claude Code」と入力し、発行元がAnthropicの公式拡張機能を確認する。似た名前の非公式拡張機能と間違えないよう注意する。
- 「インストール」をクリックする:インストールが完了したら、VS Codeのステータスバー(画面最下部)に「✱ Claude Code」と表示される。
- サインインする:Sparkアイコン(⚡)またはステータスバーの「✱ Claude Code」をクリックし、画面の指示に従ってAnthropicアカウントでサインインする。
インストール後にサインインを求める画面が出ない場合は、コマンドパレット(Ctrl+Shift+P / Cmd+Shift+P)を開き「Claude Code: Sign In」を選択すると手動でサインインできる。
日本語で使う方法
Claude Code拡張機能には専用の言語設定はない。日本語でプロンプトを入力するとそのまま日本語で回答される。VS Code自体のUIを日本語化したい場合は、拡張機能ビューで「Japanese Language Pack」を検索し、Microsoft製の「Japanese Language Pack for Visual Studio Code」をインストールする。VS Codeを再起動すれば、メニューやサイドバーが日本語表示に切り替わる。
Claude Code APIの料金やトークン消費量については、Claude APIの料金を完全解説【2026年10月最新】も参考にしてほしい。
基本的な使い方
インストールが完了したら、実際にClaude Codeを使ってみよう。ここでは3つの基本操作を解説する。
Claude Codeパネルの開き方
Claude Codeのパネルを開く方法は4種類ある。最も素早いのはVS Codeのエディタツールバー(右上)に表示されるSparkアイコン(⚡)をクリックする方法だ。他の方法としては、ステータスバー(画面最下部)の「✱ Claude Code」をクリックする、左のアクティビティバーからClaudeのアイコンを選ぶ、コマンドパレット(Ctrl+Shift+P)から「Claude Code」と入力するの3種類がある。エディタとClaude Codeの入力欄を素早く切り替えるショートカットはCtrl+Esc(WindowsおよびLinux)またはCmd+Esc(Mac)だ。
コードの編集・生成・差分確認
Claude Codeにコードの変更を依頼すると、実行前に変更箇所の差分(変更前と変更後の対比)が表示される。差分を確認してから「承認」または「却下」を選択できるため、意図しない変更が加えられるリスクを防げる。複数のファイルにまたがる変更が提案される場合も、ファイルごとに差分を確認してから反映できる。
@メンションでファイルを指定する
Claude Codeのチャット入力欄で「@」を入力すると、プロジェクト内のファイル・フォルダを候補として選択できる。たとえば「@src/app.py を見て、バグを修正して」と指定すると、指定ファイルの内容をClaudeが参照した上で回答を生成する。コンテキストに含めたいファイルを明示することで、より的確な回答が得られやすくなる。
便利な設定と機能
基本操作に慣れたら、以下の設定や機能を活用することでより効率的に使えるようになる。
承認モードの切り替え
承認モードとは、Claude Codeがコードの変更・ファイルの作成・コマンド実行を行う際に、都度確認を求めるかどうかを設定するモードだ。以下の4種類から選べる。
| モード名 | 動作 | 向いているケース |
|---|---|---|
| Manual(手動承認) | 変更のたびに確認画面が表示される | 初めて使う場合・重要なコードの変更時 |
| Auto(自動承認) | 変更を自動で反映する | 動作を把握した後の効率重視の作業 |
| Plan(計画モード) | 変更内容の計画を先に提示し、承認後に実行 | 大規模な変更を事前に確認したい場合 |
| Edit automatically | ファイル編集のみ自動・コマンド実行は確認 | コード変更は効率化しながら安全性を保ちたい場合 |
承認モードはチャット入力欄の下部にある選択肢からいつでも切り替えられる。初めて使う場合はManualモードから始め、慣れてきたらAutoモードへ移行することを推奨する。
CLAUDE.mdでプロジェクトルールを設定する
プロジェクトのルートディレクトリに「CLAUDE.md」というファイルを作成すると、Claude Codeがそのプロジェクト固有のルールを自動的に読み込む。たとえば「このプロジェクトではTypeScriptを使用する」「コメントは日本語で記述する」「テストは必ずJestで書く」などのルールをCLAUDE.mdに記述しておくと、毎回プロンプトで指示する手間を省ける。チームで共有する場合はGitリポジトリにCLAUDE.mdをコミットしておくと、メンバー全員が同じルールでClaude Codeを使える。
よく使うキーボードショートカット
| 操作 | Windows / Linux | Mac |
|---|---|---|
| Claude Code入力欄にフォーカス | Ctrl+Esc | Cmd+Esc |
| 新しい会話タブを開く | Ctrl+Shift+Esc | Cmd+Shift+Esc |
| コマンドパレットを開く | Ctrl+Shift+P | Cmd+Shift+P |
| 拡張機能ビューを開く | Ctrl+Shift+X | Cmd+Shift+X |
入力欄フォーカスのCtrl+Esc(Cmd+Esc)はエディタとClaude Code間の行き来に特に便利なため、覚えておくと作業効率が大幅に向上する。
よくあるトラブルシューティング
Claude Code VS Code拡張機能を使い始めたときに遭遇しやすいトラブルと、その対処法を解説する。
拡張機能が接続できないとき
拡張機能を起動してもAnthropicサーバーに接続できない場合、以下の順に確認する。
- プランの確認:Claudeのダッシュボード(claude.ai)でProプラン以上に加入していることを確認する。Freeプランではアカウントがあっても接続できない。
- サインインし直す:コマンドパレット(Ctrl+Shift+P)から「Claude Code: Sign Out」でサインアウトし、再度「Claude Code: Sign In」でサインインを試みる。
- VS Codeのバージョン確認:VS Codeのバージョンが1.94未満の場合、アップデートが必要だ。「ヘルプ」→「更新の確認」から最新版に更新する。
- 拡張機能の再インストール:拡張機能ビューでClaude Codeをアンインストールし、VS Codeを再起動してから再インストールする。
差分が表示されないとき
コードの変更を依頼しても差分が表示されない場合、ファイルが保存されていない状態(未保存のまま)でClaude Codeに操作させようとしているケースが多い。VS Codeの設定でオートセーブ(自動保存)を有効にするか、変更を依頼する前にCtrl+S(Cmd+S)でファイルを保存してから操作することで解消されることが多い。
まとめ
本記事で解説したClaude Code VS Code拡張機能のポイントをまとめる。
インストールはVS Codeの拡張機能ビューから「Claude Code」(発行元: Anthropic)を検索するだけで完了する。利用には月額$20のProプラン以上への加入が必要で、日本語プロンプトもそのまま使える。承認モードはManualから始めて慣れたらAutoへ移行するのがおすすめだ。CLAUDE.mdをプロジェクトルートに置くことでプロジェクト固有のルールを自動読み込みでき、チーム開発にも活用できる。
Claude CodeはCLI版とVS Code拡張機能版の2種類があり、使い方や向いているシーンが異なる。Claude CodeとCodexの比較・使い分け解説もあわせて参考にしてほしい。










