Claude Codeを使って実際に運用している2つの個人プロダクトの開発・運用プロセスを題材に、CLAUDE.md・新機能開発・リファクタリング・自動化・失敗談まで6章にまとめた本を出した。
「触ってみた系」のClaude Code記事は既に多い。本書はそこと違って、動いているプロダクトをClaude Codeで実際に作って・回している人間が、現場のディテールを書いた本になる。CLAUDE.mdの中身、permissionsの設計、自動化スクリプトの構造、ハマりパターン。すべて実プロジェクトで使っているものをベースに解説する。
価格は300円。第1章は無料で読めるので、合うかどうかをまず1章で判断してほしい。
題材にした2プロダクト
ぱんだツールズ — PDF・CSV・画像処理ツール集。Next.js 16 + TypeScript + Cloudflare Pages 構成で、83個のツール（2026年5月時点）がブラウザ内完結で動く。sakutto-panda.com で公開している。
RakuScan — プラグイン型投資分析システム。Python 3.13 + uv 構成で、16個の投資手法プラグインが日本株を毎日自動スクリーニングし、Claude APIがレポートを統合してDiscordに通知する。
いずれも書いて終わりではなく、現在進行形で運用しているプロダクトになる。本書はこの2つの開発・運用プロセスでClaude Codeをどう使っているかを章ごとに掘り下げる。
「触ってみた系」と何が違うか
Claude Codeを扱った記事や本は既に多い。多くは「触ってみた」「機能を試してみた」という紹介寄りの構成になっている。本書はそこと差別化するために、次の3つを軸にしている。
1. 実プロジェクトのCLAUDE.md・permissionsをそのまま晒す
ぱんだツールズで実際に使っているCLAUDE.mdの構造、permissionsの設計、ブランチ戦略のセクションをそのまま見せている。
# Webツールポータル — Claude Code ガイド
## プロジェクト概要 ← システム構成・ターゲット市場
## 技術スタック ← Next.js 16, TypeScript, Cloudflare Pages...
## ディレクトリ構成 ← src/lib, src/components, src/app の役割分担
## lib/ 規約 ← 純粋関数のみ、ファイル名は動詞、テスト配置
## TypeScript / コーディング規約 ← any禁止、Props named interface
## ブランチ戦略 ← main / develop / feature の三層構造
## 並列エージェント開発 ← worktree必須
特に効いているのは「ブランチ戦略」と「並列エージェント開発」のセクション。どちらも実際に踏んだ事故から追記された箇所で、なぜそのルールが要るかの背景まで第2章で書いた。
2. 「上手くいかなかった」ケースを正直に並べる
ポジティブな話ばかりだと、読者の期待値がズレる。本書では第6章を「失敗談と上手くいかないケース」に丸ごと割いた。
- 長いコンテキストで起きる幻覚（存在しない関数を呼ぶ、別ファイルの型を勝手に作る）
- UIの最後の20〜30%は手で書く方が早い
- 大規模リファクタリングで影響範囲を見誤る
- スキル化してもプロンプトの当たり外れが残る
それぞれに対策と「どこで線を引くか」を書いた。Claude Codeの限界を知っておくと、変な期待をせずに済むし、結果的に活用範囲が広がる。
3. 「コードを書く前にレビューさせる」など現場フローを言語化
リファクタリングをClaude Codeに任せるときは、いきなり「直せ」ではなく「どこが直せるか挙げろ」と指示する。
src/data/cache.pyをレビューしてほしい。
重複している処理・不要な抽象化・パフォーマンス上の問題を箇条書きで指摘して。
まだコードは書かなくていい。指摘だけ出してほしい。
返ってきた指摘を取捨選択して、必要なものだけ直させる。レビュー → 取捨選択 → 修正依頼の3段で進める——これがリファクタリングをClaude Codeに任せるときの基本フローになる、という話を第4章で実例つきで書いた。
新機能開発（第3章）も同様で、雑なプロンプトと整理されたプロンプトの差を実例で並べている。
6章の全体像
PJT別ではなく**「Claude Codeに何をやらせるか」**で章を切った。自分のプロジェクトと照らし合わせて読みやすいはず。
| 章 | テーマ | 主な題材 |
|---|---|---|
| 1 | なぜClaude Codeで個人開発が変わったか | 導入（無料） |
| 2 | 最初の設定が9割 — CLAUDE.mdとpermissions | ぱんだツールズ |
| 3 | 新機能開発での使い方 | ぱんだツールズ |
| 4 | 既存コードのリファクタリング | RakuScan |
| 5 | スクリプト・自動化を任せる | 両プロダクト |
| 6 | 失敗談と上手くいかないケース | 両プロダクト |
第1章は無料で読める。「個人開発の3つの壁（時間がない・レビュー相手がいない・地味な作業で失速する）に対してClaude Codeがどう効いたか」という、本全体の動機を凝縮した章になっている。ここを読んで合うかどうか判断してほしい。
誰に向けた本か
- 既にClaude Codeを触っているが、他人がどう使っているかを知りたい人
- 個人開発で実際に活用したいが、設定や運用の勘所が掴めていない人
- 「触ってみた系」の記事は読み終えて、もう一段深い実例が欲しい人
- CLAUDE.mdをまだ書いていない、もしくは雑な状態のまま放置している人
逆に、Claude Codeを全く触ったことがない人には向かない。本書はインストールや基本コマンドの解説は扱わない。既に使っている前提で、現場の運用ノウハウに振り切った構成になっている。
扱う範囲はコード・設定・自動化に絞った
Claude Codeの活用範囲は本来もっと広いが、本書ではコード・設定・自動化の領域にフォーカスした。テストの追加、リファクタリング、CI/CDスクリプトの整備、CLAUDE.mdの設計といった、エンジニアリング作業そのものを加速する使い方が中心になる。
読者が自分のプロジェクトに持ち帰って、すぐ試せる粒度の話に絞った。第5章の自動化パートでは GitHub Actions の YAML、Node.jsスクリプト、Playwrightテストといった「仕様が明確で、定型処理が多い」コードをClaude Codeに任せるパターンを実例つきで載せている。
まとめ
300円・6章・実プロダクト2つ分の現場記録。
第1章は無料で読める。Claude Codeを既に触っているなら、まずここを開いて、合うかどうかを判断してほしい。
関連記事もあわせてどうぞ。
- Claude Codeでぱんだツールズを作った話。PR 86本・41ツールとトークン代との戦い — 本書の題材プロダクトの開発レポート（無料）
- 「Pythonが計算し、Claudeが判断する」— 自作投資分析システム RakuScan の設計思想を本にまとめた — Python × AI 分業設計を扱ったもう1冊の紹介
この記事は Zenn にも同じ内容を投稿しています。