VS CodeでClaude Code公式拡張を使う方法

【結論】VS Codeでは公式拡張の利用が推奨

VS CodeでClaude Codeを使う場合、統合ターミナルだけでなく公式のClaude Code拡張が推奨されています。

拡張機能は独自のCLIを同梱し、選択範囲の参照、ファイルの@メンション、計画レビュー、インライン差分の承認をIDE内で行えます。

ターミナルで「claude」を直接使いたい場合だけ、別途スタンドアロンCLIも導入してください。

# VS Codeの拡張機能ビューを開く
# Windows / Linux: Ctrl+Shift+X
# macOS: Cmd+Shift+X
# 「Claude Code」を検索してInstall

# CLIも併用する場合
claude auth status --text

具体的な手順・設定方法

1. VS Code 1.94以降でプロジェクトを開き、拡張機能ビューから「Claude Code」をインストールします。

   初回起動時はブラウザでAnthropicアカウントへサインインします。

2. 編集対象を選択し、Option+KまたはAlt+Kでファイルと行範囲をプロンプトへ追加します。

   曖昧な「現在のファイル」ではなく、@参照で対象を固定してください。

3. Claudeが変更案を出したら、左右の差分を読み、AcceptまたはRejectを選びます。

   大規模変更ではPlanを先にレビューし、変更後にテストを実行させます。

   npm test

実践プロンプト / 活用テクニック

IDE拡張は視覚的なレビューに向き、CLIはパイプ処理、スクリプト、自動化に向きます。

同じリポジトリで複数セッションを動かす場合は、同一ファイルを同時編集しないよう担当範囲を分けてください。

@src/auth/login.ts のログイン処理をレビューしてください。
まずPlanとして、入力検証、認証失敗時の処理、機密情報のログ出力を確認する手順を示してください。
承認後に必要最小限の修正を提案し、差分画面で確認できるよう一変更ずつ提示してください。
最後に関連テストだけを実行し、結果を要約してください。

注意点・よくあるエラーと対処法

• 拡張機能を入れただけでは、統合ターミナルの「claude」コマンドは追加されません。

  ターミナル利用も必要ならネイティブCLIを別途インストールしてください。

  claude --version

• Sparkアイコンが表示されない場合はファイルを一つ開き、Command Paletteから「Developer: Reload Window」を実行します。

  認証画面が戻らない場合もウィンドウ再読み込みが有効です。