Claude Code を VS Code で使う設定手順と、CLI 版との違い・使い分け
Claude Code は「ターミナルで使う CLI」として始まりましたが、VS Code 拡張を入れれば、エディタの中で同じことができます。コードの差分がエディタ上で見えるので、変更を目で確認しながら進めたい人は拡張の方が快適です。
インストール
- VS Code を開き、拡張機能（Ctrl+Shift+X）で「Claude Code」を検索
- Anthropic 公式の拡張をインストール
- サイドバーに Claude のアイコンが出るので開く
- ログインを求められたら、Claude アカウント（Pro / Max）または API キーで認証
CLI 版が入っていれば、そのログイン情報が共有されるので再ログインは不要なことが多いです。
最初にやる設定
作業フォルダを開いてから使う
Claude Code は「今 VS Code で開いているフォルダ」を作業対象にします。フォルダを開かずにファイル単体を開いていると、プロジェクト全体を見られません。必ず「フォルダーを開く」で始めます。
CLAUDE.md を置く
プロジェクト直下に CLAUDE.md を置くと、毎回の指示に共通の前提（言語、ビルドコマンド、コーディング規約）を読み込ませられます。書き方は CLAUDE.md の書き方 にまとめています。
差分の確認方法を決める
拡張版の利点は、Claude が変更したファイルの差分が VS Code の diff ビューで見えることです。変更を承認する前に必ず差分を見る習慣にすると、意図しない変更を防げます。
CLI 版との違い
| VS Code 拡張 | CLI | |
|---|---|---|
| 差分表示 | エディタの diff ビュー | ターミナル内のテキスト |
| ファイル選択 | エディタで開いているファイルを参照しやすい | パスを指示で指定 |
| スクリプトからの利用 | 不向き | claude -p で可能 |
| SSH 先のサーバー | Remote 拡張経由 | 直接動く |
| 動作の軽さ | VS Code の負荷が乗る | 軽い |
機能の本体は同じです。違いは「見せ方」と「呼び出し方」です。
使い分けの目安
- 普段の開発: VS Code 拡張。差分を見ながら進められる
- 大量の定型作業、cron からの実行: CLI（定期実行の記事）
- VPS やリモートサーバー: CLI を SSH 先で動かす
- 両方: VS Code のターミナルで CLI を動かせば、1 つの画面で両方使える
Windows でつまずく点
拡張が起動しない
CLI 版と同様に Git for Windows が必要な場合があります。入っていなければ Windows インストール手順 の手順で入れて、VS Code を再起動します。
ターミナルが PowerShell で文字化けする
VS Code の設定で terminal.integrated.defaultProfile.windows を「Git Bash」にすると安定します。日本語の出力も崩れにくくなります。
WSL のプロジェクトを開く
WSL 側にあるプロジェクトは、VS Code の「WSL に再接続」で開くと、拡張も WSL 側で動きます。/mnt/c 経由で開くと遅くなるので避けます（遅いときの対処）。
私の使い方
（執筆中）
まとめ
- 拡張版は差分をエディタで見られるのが最大の利点
- 契約・上限は CLI と共通
- 「フォルダーを開く」「CLAUDE.md を置く」「差分を見てから承認」の 3 つを最初に
- スクリプト実行やサーバー上では CLI、それ以外は拡張で十分
よくある質問
Q. VS Code 拡張と CLI は別々に契約が必要ですか？
いいえ。同じ Claude アカウント（Pro / Max）または API キーで両方使えます。上限も共通です。
Q. VS Code 拡張だけで完結しますか？
日常の開発はほぼ完結します。CLI 版にしかない機能（一部のコマンドやスクリプトからの利用）が必要なときだけ CLI を使えば十分です。
Q. Cursor や Windsurf でも使えますか？
VS Code ベースのエディタでは拡張が動くことが多いですが、公式サポートはエディタごとに異なります。動かない場合は CLI 版をエディタ内ターミナルで使えば同じことができます。
検証環境: Windows 11 Pro / VS Code / 2026-09-19 時点。料金や仕様は変更されることがあるため、最新情報は公式サイトで確認してください。