Claude Code を使いこなすうえで押さえておきたいコマンド・指示パターンを10個まとめました。 これを知っているか知らないかで、作業スピードに大きな差が生まれます。

コマンド一覧

1. /edit — 部分修正で爆速

ファイル全体を書き直すのではなく、特定の箇所だけを修正したいときに使います。

/edit auth.py の login 関数のバリデーション処理を修正して

変更箇所を絞ることで、Claude が意図を正確に把握しやすくなり、意図しない書き換えを防げます。

2. /diff — 変更点だけ確認

Claude が加えた変更内容を一覧表示します。大量に編集した後に「何が変わったか」を素早く把握できます。

/diff

git diff の感覚で使えるため、コードレビュー前の最終確認に重宝します。

3. /undo — 即戻せる

直前の変更を取り消します。「やっぱり前の方が良かった」というときに即座に元に戻せます。

/undo

Claude Code はセッション内の変更履歴を保持しているため、複数回の /undo で遡ることも可能です。

4. /run — 実行まで自動

コードの生成だけでなく、その場で実行まで完結させます。スクリプトの動作確認やテスト実行を素早く回せます。

/run scripts/migrate.py を実行して結果を確認して

実行結果のエラーも自動で拾い、修正まで一気に進めてくれます。

5. /test — テスト生成

実装コードに対応するユニットテストを自動生成します。テストを書く手間を大幅に削減できます。

/test UserService クラスのテストを生成して

既存のテストフレームワーク(pytest、Jest など)を検出して、プロジェクトのスタイルに合わせたコードを出力してくれます。

6. /fix — エラー修正

エラーメッセージをそのまま貼り付けるだけで、Claude が原因を分析して修正します。

/fix TypeError: 'NoneType' object is not subscriptable

スタックトレースごと渡すと、より正確な修正が得られます。

7. /refactor — 最適化

動いているコードをより読みやすく・効率的な構造に書き直します。

/refactor この関数を読みやすくリファクタリングして

「どう直すか」を指示しなくても、Claude がベストプラクティスに沿って提案してくれます。

8. /search — 全体検索

プロジェクト全体から特定のキーワードや処理を含むファイルを探します。

/search JWT トークンの検証処理を行っている箇所を全部探して

grep や IDE の検索より自然言語で指示できるのが利点です。

9. /commit — コミットメッセージ作成

変更内容を解析して、適切なコミットメッセージを自動生成します。

/commit

Conventional Commits 形式(feat:, fix:, refactor: など)に合わせたメッセージを提案してくれます。

10. /doc — ドキュメント化

関数やクラスに docstring・コメントを自動で追加します。API ドキュメントの生成にも活用できます。

/doc payment.py の関数に docstring を追加して

効果的な使い方のコツ

具体的に伝える
「かっこよくして」より「黒背景・ゴールドのグラデーション・グロー効果を追加して」のように詳細に指示するほど、期待通りの出力が得られます。

一度に一つ
複数の変更を一気に頼むより、一つずつ確認しながら進める方が品質が高まります。

エラーはそのまま貼る
エラーメッセージをコピーして Claude Code に渡すと、自動で原因を特定して修正してくれます。

参考サイトのイメージを伝える
「〇〇のサイトみたいに」「Xのプロフィール画像みたいに丸く」など、イメージを共有することで Claude が意図を正確に解釈してくれます。

まとめ

Claude Code のコマンドを活用することで、コーディングの各フェーズ(実装→テスト→修正→コミット→ドキュメント)を効率的に進められます。 「何をしたいか」を明確に伝えることが、AI との協働を最大化する鍵です。

ソース: @kkk_cun のポスト