Claude Codeで既存コードベースを読む: 45分で地図を作り、小さく直す手順

なぜこの流れが必要か

新しいリポジトリより、既存コードベースのほうがClaude Codeの価値は出やすいです。ただし最初に全体を書き換えようとすると、テストも導線も壊しやすくなります。まず必要なのは、完璧な理解ではなく、触ってよい場所、触らない場所、検証できる小さな作業を分ける地図です。

関連して、基礎を固めるなら Claude Code入門, harness engineering, 権限ガイド。

実務で使う手順

45分の流れは、状態確認、ファイル地図、1つだけの修正、証拠、引き継ぎメモです。特に収益導線があるサイトでは、本文だけでなく無料PDF、Gumroad、導入相談へのリンクが残っているかを毎回確認します。

コピペできる最小セット

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

実例: 3つの使いどころ

• ブログ記事の末尾CTAだけを直し、無料PDFの登録文言を明確にする。
• 古いCLAUDE.mdに安全なコマンド、禁止領域、完了条件を追加する。
• 人気記事から商品ページへの内部リンクを1本増やし、公開URLでh1とCTAを確認する。

失敗例と避け方

失敗例は、最初の依頼を「全体をリファクタして」にすることです。Claude Codeは広い変更も提案できますが、既存コードでは差分が大きいほどレビュー不能になります。まずは1ファイル、1導線、1検証コマンドに絞ります。

無料PDF・Gumroad・導入相談への導線

この手順に慣れるまでは無料チートシートでコマンドを見ながら進めてください。既存コードベース向けのCLAUDE.md、hooks、権限設計まで整えるならSetup Guideが近道です。チームの導入順序や収益導線まで決めたい場合は導入相談が向いています。

• 無料Claude Codeチートシート
• プロンプトテンプレート集
• Claude Code Setup Guide
• 商品一覧
• 導入相談

まず無料チートシートでコマンドを確認し、作業を標準化したくなったらGumroad教材、チーム導入や収益導線まで設計するなら導入相談に進んでください。

この記事の検証メモ

この記事ではPowerShellで読めるコマンド、Markdownとして使えるCLAUDE.md断片、公開前に確認すべきCTA項目を分けました。ローカル記事だけで完了とせず、公開URLで本文と導線を見る前提にしています。