Claude Code IDE統合完全ガイド|VSCode・JetBrainsでの使い方・チェックポイント機能まで徹底解説

Claude Code IDE統合完全ガイド|VSCode・JetBrainsでの使い方・チェックポイント機能まで徹底解説 AI開発

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以上)が必要です。以下のいずれかの方法でインストールできます。

  1. VSCodeのExtensionsパネル(Ctrl+Shift+X)で「Claude Code」を検索 → Install
  2. Quick Open(Ctrl+P)を開いて ext install anthropic.claude-code を実行
  3. コマンドラインから code --install-extension anthropic.claude-code を実行
VSCode 1.98.0以上が必須
古いバージョンのVSCodeではClaude Code拡張が動作しません。Help → Check for Updates から最新版にアップデートしてください。

拡張機能とCLIの関係

Claude Code拡張をインストールしたあと、VSCodeの統合ターミナルでclaudeを実行するだけでIDE統合が自動的に有効になります。拡張機能が稼働中のVSCodeプロセスを検出して自動接続するため、特別な設定は不要です。

外部ターミナル(iTerm2・Windows Terminalなど)からClaude Codeを起動した場合は、--ideフラグを使って接続します。

外部ターミナルから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はファイルシステムも戻る
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を再起動してください。

JetBrains Plugin Marketplaceからのインストール
# 設定から検索してインストール
# 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版はグラフィカルパネルが非対応
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サポートはありますが、設定が複雑になる場合があります。