CC Tips: AIコーディングで本当に知っておくべきこと(vibeコーディングではなく)
2026-08-13
- プロジェクトルートに
CLAUDE.mdを置き、技術スタック・DBスキーマ・APIパターン・ブランチ命名規則などプロジェクト固有ルールを明記する(グローバルなコーディング規約は別途ユーザー設定側に)
- サブモジュールごとに挙動を変えたい場合は、その配下にも個別の
CLAUDE.mdを置いて上書きする
- プロンプトは「〇〇テーブルに真偽値フィールドを追加し、APIエンドポイントで公開し、そのフィールドに応じてUIを条件分岐させる」のように具体的に書き、曖昧な依頼でAIに推測させない
- 大きな機能追加はまず「コードを書かずに実装計画だけ出させる」プロンプトを投げ、計画を確認してから「このプランどおりに、次の制約(編集対象ファイル限定・新規依存追加禁止など)で実装して」と続ける
- 計画立案が得意なモデルと実装が得意なモデルを使い分け、会話の途中で無駄にモデルを切り替えない(切り替えるとコストが余計にかかる)
- 1つの会話(セッション)は1タスクに絞り、短く保つ(履歴が毎回コンテキストに含まれるため長引くほどコストが増す)
- ファイルを
@参照したり該当コードをハイライトしてコンテキストとして渡すことで、コードベース全体を毎回検索させずに済みトークンを節約できる
- UIバグはスクリーンショットを添付して修正を依頼できる
- 生成されたコードは鵜呑みにせず、「なぜこの実装にしたか」「エラーケースは」「パフォーマンスへの影響は」と質問し、必要なら自分で編集してから続きをAIにやらせる
- 独立したタスクを並列で進めたい場合はgitのworktreeを使って複数のAIセッションを同時に走らせ、それぞれの操作を個別に承認/却下する
- 自動実行してよいタスクと承認が必要なタスクをパーミッション設定で切り分けておく
- エージェントが制御不能になったら中断し、直前のコミットやチェックポイントに戻す