【結論】初期設定から実装までの開発手順
Claude Codeを使う開発手順は、導入、認証、リポジトリ理解、計画、実装、検証、レビュー、コミットの順で進めます。
最初からclaude -pで環境構築を丸投げするより、対話セッションで計画と権限要求を確認する方が安全です。
プロジェクト固有の規約は/initで生成したCLAUDE.mdを人間が編集して固定します。
# ターミナルで実行:作業対象へ移動
cd ~/projects/my-app
# ターミナルで実行:Gitの状態を確認
git status --short
# ターミナルで実行:Claude Codeを起動
claude
# Claude Code起動後のセッション内で実行:案内ファイルを初期化
/init
具体的な手順・設定方法
最初の依頼では「コードを変更せず、構成、テスト方法、主要リスクを調査」と指示します。
次にセッション内の
/planで実装方針を作り、対象外ファイルと完了条件を明示します。実装後は
/diffとプロジェクトのテストを確認し、問題なければGitへコミットしてから次のタスクへ進みます。
実践プロンプト / 活用テクニック
認証APIを追加する例では、実装範囲と検証方法を一度に指定します。
src/api/auth 配下だけを対象に、ログインAPIを追加してください。
既存の認証方式とエラーハンドリングを先に調査し、変更計画を提示して承認を待ってください。
承認後に実装し、関連テストと型チェックを実行してください。
最後に変更ファイル、テスト結果、デプロイ時の注意点を要約してください。
注意点・よくあるエラーと対処法
/clearはハルシネーションを消す魔法ではなく、会話コンテキストを空にするコマンドです。
関連タスクの途中では/compact、無関係なタスクへ切り替えるときは/clearを使い分けます。
デプロイやDBマイグレーションは外部副作用があり巻き戻せないため、Claudeへ実行させる前にコマンド、対象環境、復旧手順を人間が確認してください。