Claude Codeの使用方法：ファイル指定・Plan・検証の基本

【結論】ファイル指定、Plan、検証の型を使う

Claude Codeの実践的な使用方法は、関連ファイルを@で指定し、Planモードで変更案を確認してから実装とTestへ進むことです。

長い会話では/contextで内訳を確認し、関連作業は/compact、別作業は新規Sessionへ分けます。

恒久規約はCLAUDE.md、反復手順はSkill、専門担当はSubagentへ分離します。

# ターミナルで対象Repositoryを開く
cd ~/projects/my-app
# ターミナルでClaude Codeを起動
claude
# 起動後のセッション内でContextを確認
/context

具体的な手順・設定方法

1. @src/api/client.tsのようにFileを指定し、目的と変更禁止範囲を伝えます。

2. Planモードで影響範囲、Test、Migration、Rollbackを確認します。

3. 実装後はClaudeの説明だけでなく、実際のTest結果とGit diffを人間が確認します。

# 起動後のセッション内でPlanモードへ切り替え
/plan
# 起動後のセッション内で履歴を圧縮
/compact API移行の決定事項と未完了タスクを保持
# 起動後のセッション内で過去Sessionを選ぶ
/resume

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

ClaudeへFile名だけでなく、期待する入力・出力、Error case、Performance条件を渡します。

大量File変更は一つのCommitへ詰めず、動作確認できる単位へ分けます。

@src/api/client.ts と @tests/api/client.test.ts を対象にしてください。
Timeout時のRetryを最大2回、指数Backoff、非対象Errorは即時失敗とします。
まずTest caseを追加し、その後に実装して全Test結果を報告してください。

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

CLAUDE.mdを長大な百科事典にせず、検証可能な規約と頻用Commandだけを残してください。