ai-technology

Claude CodeとVS Codeを組み合わせる基本

Claude CodeとVS Codeを組み合わせる基本

はじめに

Claude Code はターミナルベースのツールですが、VS Code と組み合わせることで、効率的な開発ワークフローが実現できます。本記事では、基本的な組み合わせ方を解説します。

基本ワークフロー

【Step 1】VS Code でプロジェクトを開く
【Step 2】Claude Code でコード修正
【Step 3】VS Code で diff を確認
【Step 4】VS Code のターミナルで git commit
【Step 5】テスト・ビルド

Step 1:VS Code でプロジェクトを開く

方法

# PowerShell から
code C:\Projects\my-app

# または VS Code のメニューから
File → Open Folder → フォルダ選択

確認すべき項目

✅ .git フォルダが見える
✅ src / main.py など作業対象ファイルが見える
✅ README.md がある
✅ .gitignore がある

Step 2:Claude Code でコード修正

Claude Code の実行

Claude Code CLI で実行
(または VS Code の拡張機能から実行)

結果:
ファイルが自動修正される

Claude Code の出力を確認

VS Code のコンソール / ターミナル で
「修正内容」を表示

Step 3:VS Code で diff を確認

方法1:Git の Source Control パネル

VS Code 左パネル → Source Control

変更されたファイル一覧が表示

各ファイルをクリック → diff 表示

方法2:ターミナルで確認

git diff

# または特定ファイル
git diff src/main.py

確認すべき項目

✅ 変更行が意図通りか
✅ 削除すべき行が削除されているか
✅ 追加すべき行が追加されているか
✅ 不要な変更がないか

Step 4:VS Code のターミナルで commit

ターミナルの開き方

VS Code 下部 → Terminal
(または Ctrl + `)

提案される手順

# 1. ステージング
git add src/main.py

# 2. diff 確認(最終確認)
git diff --cached

# 3. コミット
git commit -m "Fix: function A performance"

Step 5:テスト・ビルド

VS Code のターミナルで実行

# テスト
npm test

# ビルド
npm run build

# ローカルサーバー
npm start

実装例:一連の流れ

例:関数の最適化

【VS Code】
- プロジェクトを開く
- README で目的確認
- function_a.py を確認

【Claude Code】
claude-code --file src/function_a.py

「関数 A の処理時間を 50% 短縮。出力は同じ」

【VS Code】
- diff で修正内容確認 ✅
- ターミナルで git status
- git diff で最終確認
- git add / commit

【テスト】
npm test で動作確認 ✅

よくある失敗

❌ 失敗例1:VS Code を更新せず確認

Claude Code で修正

VS Code で古いバージョンのファイルを見ている

diff が見えない

誤認識

✅ 改善例

VS Code ウィンドウをアクティブにする

ファイルが自動更新

正確な diff を確認

❌ 失敗例2:diff を確認せずコミット

Claude Code で修正

すぐに commit

意図しない変更を含む

後で気づく

✅ 改善例

必ず diff を確認

OK なら commit

NG なら修正

まとめ

Claude Code と VS Code の組み合わせ:

基本ワークフロー

  1. VS Code で開く
  2. Claude Code で修正
  3. VS Code で diff 確認
  4. ターミナルで commit
  5. テスト・ビルド実行

重要ポイント

安全で効率的な開発が実現します。

Claude Codeで安全に作業するためのGit準備と合わせることで、確実な開発ワークフローが構築できます。