失敗を資産に変えるClaude Code

Claude Codeを毎日相棒として使い倒している中で見つけた運用の話をします

Transcript

1. 同じ失敗を、二度はさせない Claude Codeに「失敗を資産化」させる 自作の評価ログ＆ナレッジ運用 斉田 真也 Claude Code Meetup Osaka / 2026.06.17 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 1
2. 自己紹介 斉田 真也（さいた しんや） 株式会社ラクスでバックエンドエンジニア Markdownエディタ Bokuchi を個人開発 中（OSS） 趣味：ものづくり全般 / カードマジック Claude Codeは 公私ともに 頼った相棒 GitHub: shinya / X: @saita_shinya 2
3. つくっているもの：Bokuchi 軽量 Markdown エディター 軽い・速い — Tauri製でElectronより省メモリ 完全オフライン — 書いたものは外に出ない 完全無料・オープンソース（MIT） 数式(KaTeX)・図(Mermaid)・スライド(Marp)対応 — このスライドもBokuchiで書いています 仕事と、この個人開発。 どちらもClaude Codeを“相棒”として使い倒すきっかけになりました 3
5. Bokuchi、ぜひ使ってみてください こんな人に Markdownを 軽快に 書きたい 無料 でずっと使えるエディタが欲し い Markdownの編集だけにVSCode使 うのはな・・・という人 bokuchi.com でダウンロードできます Mac / Windows / Linux 対応 完全無料・オープンソース（MIT） GitHub: github.com/Bokuchi-Editor/bokuchi 5
6. 今日言いたいこと AIは 失敗する（皆さんご存知）けど 「失敗を 記録して学ぶ仕組み」があれば、 二度目から賢くなるよ！ ※ 当たり前のことではある。運用＝CLAUDE.mdだけで実現する話です。 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 6
7. きっかけ：Claude Codeあるある こんな経験ないですか 前のセッションで直したのに また同じミスをする 「PRの文章はこう書いて」と毎回言 ってる プロジェクトを変えると 学びがリセットされる ならば 頼んだ内容をログに残す 自分の反応（OK/NG）を 自動で点数化 失敗をナレッジに抽出して 次回読ませる 「覚えておいて」とかをわざわざ言わなくても良いようにしたかった Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 7
8. Part 1 仕組み編 〜 AIに自己学習させる 〜 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 8
9. 仕組み：5ステップのループ ぜんぶ CLAUDE.md に書いたルールだけ で回る（コードゼロ） Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 9
10. 心臓部：反応を「点数」に変換 ユーザーの何気ない一言を、Claude自身が判定して記録する 判定 score 言い回しの例 採用 1.0 ありがとう / いいね / 完璧 / それで 微妙 0.5 ちょっと違う / ここだけ直して / 惜しい 却下 0.0 違う / やり直して / 不要 / こっちでやる → 却下・微妙がついたら、その理由をナレッジに1行追記 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 10
11. 蓄積されたもの（3ヶ月分） 約240件 依頼ログ 122件 評価ログ 8カテゴリ ナレッジ抽出 評価のうち 却下は12回（約1割） 。 この12回が、いちばんの財産 になる。 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 11
12. ナレッジはこんな形で残る カテゴリ別（code-design / bug-fix / testing …）の Markdown に蓄積 外部サービス連携（Webhook等）は、似たサービスや旧バージョンからの 類推で書式・挙動を推測しない。必ず使う前に仕様を確認する。 これを 次の提案の前に毎回読み込む ので、 同じ失敗を 別プロジェクトでも繰り返さない Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 12
13. 「標準のメモリ機能でよくない？」 よく聞かれます。でも狙いが違います 観点 標準のメモリ この取り組み 記録するもの 事実・好み 依頼＋その結果（採用/却下） 成否の追跡 しない（覚えるだけ） 点数化して追跡 参照のされ方 関連度ベース（出ない時も） 提案前に必ず読む 標準メモリ＝静的な記憶 / この取り組み＝失敗を回収する動的なループ この仕組みを約3ヶ月運用中。 「採点して失敗を回収する」発想は今も標準機能にはない。 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 13
14. Part 2 失敗編 〜 却下ログから生まれた教訓 〜 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 14
15. 失敗①：言われたことを守らない 「フォーマットがバラバラ。 PRは規定のフォーマットで書くよう何度も指示済み」 メモリに「PRはフォーマットに従う」ルールがあったのに従わなかった → score 0.0（却下） 教訓：明示ルールは提案前に必ず突き合わせる Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 15
16. 失敗②：頼んでないのに先に進む 「原因を聞いただけなのに、修正まで進めた。 段階を踏むべき」 「原因は？」への回答だけでよかったのに、勝手にコードを直した → 依頼スコープの越権で却下 教訓：質問には“説明だけ”。修正は依頼されてから Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 16
17. 失敗③：勝手にcommit & push 「未確定の情報が現れた時点で、あなたは私に相談すべきです。 何故勝手に作業を進めましたか？」 git identity未設定 → 環境変数から推測した値でcommit/pushまで完遂 → 最も重い却下のひとつ 教訓：埋められそうでも“未確定”なら、影響が残る操作の手前で必ず止まる Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 17
18. 失敗④：数字で判断を誤らせる 「3.1MBと聞いて検討したが、実際は展開後8.2MB。 軽量アプリに+45%は許容できない。見送り」 圧縮zipサイズだけ提示 → 実使用サイズと混同させた → 却下（誤った判断を誘発） 教訓：サイズは「圧縮後」と「展開後」を必ず区別して伝える Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 18
19. 失敗を、その場で消えないようにする 通常 却下される → その場で直す → 言わない限り次のセッションで再発 この運用 却下される → 理由をナレッジに1行 → 次回以降は言わなくても事前に回避 失敗が 使い捨て から 資産 に変わる Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 19
20. AIは失敗する。 大事なのは“忘れない仕組み” 失敗を記録して抽出すれば、 相棒は セッションをまたいで 賢くなる Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 20
21. 持ち帰ってほしいこと 1. CLAUDE.mdは“設定”じゃなく“運用ルール”を書く場所 コードを書かずに、自然言語のルールだけで挙動を変えられる 2. 却下・微妙を記録する。それが一番の教材 うまくいった事例より、失敗の理由のほうが価値が高い 3. 学びはプロジェクトを越えて共有する ナレッジを別リポジトリに切り出して毎朝push、全セッションで参照 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 21
22. 少しだけ、宣伝 今日話した“相棒”を一緒に育てている会社 Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 22
23. 複数プロダクト組織であるラクスのAI戦略が聞けます connpassで 申し込めます 23
24. キャリア採用、積極的にしてます！ 24
25. ありがとうございました 「同じ失敗を、二度はさせない」 エンジニアリングを皆さんもぜひ！ 斉田 真也 / GitHub: shinya / X: @saita_shinya Claude Code Meetup Osaka / 失敗を資産に変えるClaude Code 斉田 真也 @ Claude Code Meetup Osaka / GitHub: shinya / X: @saita_shinya 25