Claude Codeはターミナルから使うCLIツールですが、VSCode・JetBrains IDEに拡張機能をインストールすることでIDEとの緊密な連携が実現します。エディタで開いているファイルの差分確認・IDE診断エラーの自動共有・インライン編集の承認/却下といった操作が、ターミナルを行き来せずに行えます。
この記事では、VSCode拡張とJetBrains統合プラグインのインストールから実際の使い方・高度な機能まで解説します。Claude Code全般の概要はClaude Code完全ガイドを参照してください。
Claude CodeのIDE統合はGitHub CopilotのようなリアルタイムのコードCompletionは提供しません。Claude Codeは会話型のAIエージェントであり、コードを一緒に書く・レビューする・リファクタリングする用途に特化しています。コード補完とエージェント型AIは思想が異なり、両立を目指す設計ではありません。
VSCode拡張のインストールと初期設定
インストール方法
VSCode(バージョン1.98.0以上)が必要です。以下のいずれかの方法でインストールできます。
- VSCodeのExtensionsパネル(
Ctrl+Shift+X)で「Claude Code」を検索 → Install - Quick Open(
Ctrl+P)を開いてext install anthropic.claude-codeを実行 - コマンドラインから
code --install-extension anthropic.claude-codeを実行
古いバージョンのVSCodeではClaude Code拡張が動作しません。
Help → Check for Updates から最新版にアップデートしてください。拡張機能とCLIの関係
Claude Code拡張をインストールしたあと、VSCodeの統合ターミナルでclaudeを実行するだけでIDE統合が自動的に有効になります。拡張機能が稼働中のVSCodeプロセスを検出して自動接続するため、特別な設定は不要です。
外部ターミナル(iTerm2・Windows Terminalなど)からClaude Codeを起動した場合は、--ideフラグを使って接続します。
# VSCodeが1つだけ開いている場合: 自動で接続 claude --ide # IDEが複数開いている場合は選択肢が表示される claude --ide # → "Which IDE would you like to connect to?" # > project-a (VSCode) # > project-b (VSCode)
VSCode統合の主要機能
チャットパネル
VSCode拡張をインストールするとサイドバーにClaudeのアイコンが追加されます。クリックするとチャットパネルが開き、ターミナルを開かずにClaudeと会話できます。チャットパネルはサイドバー・エディタタブ・別ウィンドウのいずれかに配置できます。
- 複数会話の同時起動: タブを複数開いて別々のタスクを並行処理
- 会話履歴の検索・再開: 過去の会話を検索して続きから再開
- 会話のエクスポート: 会話内容をMarkdownとして保存
Diff表示とAccept/Reject
ClaudeがファイルをEdit(編集)すると、VSCodeのDiff Viewerで変更前後の差分が表示されます。コードの変更内容を確認してからAccept(承認)またはReject(却下)できるため、意図しない変更を防げます。
変更ごとに個別にAccept/Rejectすることも、まとめて一括承認することも可能です。Plan Modeと組み合わせると、実装前に計画を確認してから承認→実装→Diff確認という安全なフローが組めます。Plan Modeの詳細も参考にしてください。
@ファイルメンション
チャット入力欄に@と入力すると、ファイル・フォルダをメンションできます。ファジーマッチで絞り込めるため、長いパスを手入力する必要はありません。
| 操作 | 方法 | 効果 |
|---|---|---|
| ファイルをメンション | @ファイル名(ファジーマッチ) |
指定ファイルをClaudeのコンテキストに追加 |
| 現在の選択をメンション | Alt+K(Windows/Linux)/Option+K(Mac) |
選択中のコードをファイル名・行番号付きで挿入 |
| ターミナル出力を参照 | @terminal:ターミナル名 |
直近のターミナル出力をClaudeに共有 |
| ブラウザ操作 | @browser(Chrome拡張が必要) |
ブラウザの現在のページを操作・参照 |
IDE診断情報の自動共有
VSCode拡張はエディタのDiagnostics(診断情報)を自動的にClaudeに共有します。TypeScriptの型エラー・ESLintの警告・未使用変数の指摘など、IDEが検出しているエラーをClaudeが自動的に認識して修正提案を出せます。
- TypeScriptの型エラーを修正したい(「エラーを全部直してください」で一括対応)
- ESLintの警告をまとめて解消したい
- 赤波線が消えない原因を調べたい
チェックポイント機能:Rewindで任意時点に戻る
Claude Codeで複数のファイルを変更したあと、「やっぱり3つ前の状態に戻したい」というケースがあります。チェックポイント機能(Rewind/Fork)を使うと、会話の任意時点にさかのぼってファイルをその状態に戻せます。
| 機能 | 動作 |
|---|---|
| Rewind | 現在の会話を選択した時点まで巻き戻す。その後は同じ会話の続きとして再開 |
| Fork | 選択した時点から新しい別の会話として分岐させる。元の会話はそのまま残る |
Rewind/Forkは会話の各ターン(Claudeの返答)に表示される時計アイコンから操作できます。Forkを活用すると「同じ起点から別のアプローチを試す」という実験的な使い方が可能です。
Rewindを行うとファイルの実際の内容もその時点の状態に戻ります。git commitしていない変更が失われる可能性があるため、重要な変更は先にコミットしておきましょう。
JetBrains IDEとの統合
対応IDEとインストール方法
JetBrains製IDEへの統合はβ版のプラグインとして提供されています。以下のIDEに対応しています。
- IntelliJ IDEA(Community / Ultimate)
- PyCharm(Community / Professional)
- WebStorm
- PhpStorm
- GoLand
- Android Studio
インストールはJetBrainsのPlugins(設定画面)からできます。「Claude Code [Beta]」で検索してインストール後、IDEを再起動してください。
# 設定から検索してインストール # Settings (Cmd+, / Ctrl+,) → Plugins → Marketplace タブ # → "Claude Code" で検索 → Install → IDEを再起動 # インストール後の起動ショートカット(デフォルト) # Mac: Cmd+Esc # Windows: Ctrl+Esc
JetBrains版の主な機能
JetBrains版の機能はVSCode版と基本的に同じですが、いくつか違いがあります。コード変更はJetBrainsネイティブのDiff Viewerで表示されるため、IDEのUXに馴染んだ形で確認できます。
Cmd+Option+K(Mac)/Alt+Ctrl+K(Windows)でファイル参照(@File#L1-99形式)を挿入- IDEのコード解析結果(lint・syntax・型エラー)をClaudeに自動共有
- 現在開いているファイル・選択範囲が自動的にコンテキストに含まれる
JetBrains版にはVSCode版のようなサイドバーチャットパネルはありません。ショートカットキーでClaudeウィンドウを開いて操作します。リモート開発時はリモートホスト側にプラグインをインストールする必要があります(Settings → Plugins (Host))。
VSCode版とJetBrains版の機能比較
| 機能 | VSCode | JetBrains |
|---|---|---|
| チャットパネル(GUI) | ✅ サイドバー/タブ/別ウィンドウ | ❌ なし(ショートカットで起動) |
| Diff表示・Accept/Reject | ✅ VSCode Diff Viewer | ✅ JetBrains Diff Viewer |
| @ファイルメンション | ✅ ファジーマッチ | ✅ @File#L1-99形式 |
| IDE診断情報の共有 | ✅ 自動共有 | ✅ 自動共有 |
| チェックポイント(Rewind/Fork) | ✅ あり | ✅ あり |
| @browser統合 | ✅ Chrome拡張v1.0.36以上 | ❌ 非対応 |
| 複数会話の並列管理 | ✅ 複数タブ | △ 制限あり |
| 安定性 | 安定版(正式リリース) | β版([Beta]) |
| 最低バージョン要件 | VSCode 1.98.0以上 | 最新の安定版を推奨 |
IDE統合を活用した実践的な使い方
TypeScriptエラーを一括修正する
VSCode + TypeScriptプロジェクトでエラーが大量に出ているとき、Claude Codeが診断情報を自動で受け取っているため、「TypeScriptのエラーをすべて直してください」と一言伝えるだけで対処できます。
Diff確認しながらリファクタリングする
大規模なリファクタリングをClaude Codeに任せるとき、IDE統合を使うとファイルごとのDiffを確認しながら変更を承認できます。不要な変更はRejectして次のファイルに進むという操作が、エディタ上で完結するのが便利です。さらにSubagentsと組み合わせると、複数ファイルの並行処理も可能です。
チェックポイントで実験的に変更を試す
「まずAパターンで実装してもらい、気に入らなければBパターンに分岐させる」という実験的な開発に、Fork機能が役立ちます。チェックポイントを使えばgit stashなしで複数のアプローチを試せます。
まとめ
Claude CodeのIDE統合は、エディタで作業しながらAIとシームレスに連携できる環境を提供します。VSCode拡張(正式版)はチャットパネル・Diff表示・@メンション・チェックポイントと機能が豊富で、JetBrains版(β)はネイティブDiff ViewerとIDEのコード解析共有が強みです。
どちらもコード補完(インライン補完)は提供しませんが、代わりにより高度な「コードを理解して変更する」エージェント型の支援が受けられます。IDEとターミナルを行き来せずに、エディタ内でClaudeの変更をレビューできるのが最大の利点です。
よくある質問
QClaude Code拡張はコード補完(インライン補完)に対応していますか?
A対応していません。Claude CodeはGitHub Copilotのようなリアルタイムのコード補完ツールとは設計思想が異なります。Claude Codeは会話型のAIエージェントであり、コードの理解・生成・リファクタリングを会話形式で行います。コード補完が必要な場合はCopilotやContinue等と併用してください。
QVSCode拡張を使うときにClaude Codeのインストールは必要ですか?
Aはい、VSCode拡張はClaude Codeのインターフェースを提供するものであり、バックエンドとしてClaude Code(npm install -g @anthropic-ai/claude-code)のインストールが必要です。Anthropicアカウントへのログインも必要です。
QJetBrains版とVSCode版、どちらを使えばいいですか?
A普段のエディタに合わせて選んでください。VSCodeユーザーにはチャットパネルやブラウザ統合など機能が豊富なVSCode版を推奨します。IntelliJ / PyCharm等のJetBrainsユーザーはJetBrains版(β)を使うとIDEのDiff Viewerとの連携が自然です。ただしJetBrains版はβのためVSCode版より安定性が劣る場合があります。
QRewindで前の状態に戻したのに、一部のファイルが元に戻りませんでした。
ARewindが戻せるのはClaude Codeが編集したファイルのみです。Claudeを通さずに自分で直接編集したファイルはRewindの対象外です。また、git commit済みの変更はRewindでは変更されません(gitのコミット履歴は独立しています)。
Q–ideフラグと統合ターミナルからの起動は何が違いますか?
AVSCodeの統合ターミナル(ビルトインターミナル)からclaudeを実行した場合は、拡張機能がVSCodeプロセスを検出して自動接続します。--ideフラグは外部ターミナル(iTerm2・Windows Terminal等)から起動するときに、「このClaude Codeセッションを特定のIDEに接続する」と明示的に指定するためのものです。どちらの方法でも同じIDE統合機能が使えます。
QWSL2環境でClaude Code IDE統合は使えますか?
A使えますが追加設定が必要です。VSCode拡張はWSL拡張機能(Remote – WSL)経由でWSL2プロセスに接続します。WSL2側でClaude Codeをインストールして、WSL2のターミナルからclaudeを起動してください。JetBrains版もWSL2サポートはありますが、設定が複雑になる場合があります。

