Claude Codeの同じミス対策|揃えた設定が戻っていた
この記事は約20分で読めますこの記事の目次
※当サイトにはアフィリエイト広告が含まれます。本記事の本文にアフィリエイトリンクはありませんが、筆者が運営する点検室と相談サービス、公式LINEの案内を含みます。記事の前後には、サイト共通の広告(アフィリエイト広告を含む)が表示されます。
Claude Codeの同じミスが、ルールを書き足したあとも戻ってくる。その原因の1つは、揃えたはずの設定のずれでした。
この記事の結論
Claude Codeで同じミスが戻る原因の1つは、揃えたはずの設定のずれです。私の環境では、揃えたはずの2週間後に数え直すと、エージェント21本のうち3本が別のモデルでした。そこで点検表でずれを拾い、エージェント1体ごとの学び帳で次に持ち越す仕組みを入れました。
ルールを書いた。読ませた。なのに、また同じところで止まる。バイブコーディングでサブエージェント(役割ごとに分けたAI担当)を自分で作ったことがある人なら、1度は味わった感覚だと思います。
CLAUDE.mdが長くなりすぎた人。担当を何本も増やして、どれが何をしているか追えなくなった人。あるいは1本だけ作って、毎回同じ注意を打ち込んでいる人もいるはずです。
先に言い切ります。エージェントが1本しか無くても、学び帳は作れます。必要なのはMarkdownファイル1枚と、1行の書式だけ。この記事では、私が自分の環境を数え直して見つけたずれと、その返事として入れた学び帳の型を、写せる形で置いていきます。
Claude Codeの同じミスはなぜ止まらないのか?
Claude Codeの同じミスが止まらない理由は、書いたルールが守られる前提そのものが、知らないうちに崩れていることにあります。私の場合は、エージェントごとに決めていたモデル指定が、揃えたはずの状態から戻っていました。
「書いたのに守られない」と感じている人は多い
同じ悩みを書いた記事を探すと、すぐに見つかります。Zennには、こんな一文がありました。
200行のルール。全て、Claude が失敗したから書いた。全て、Claude に読まれているはずだ。全て、守られていない。
Zenn「200行のルール」の記事より
noteで見つけた体験談も、気持ちの出どころは同じでした。
「あれ、またここで詰まったな」という感覚が何度か積み重なったとき、頭の中だけで覚えておくのは無理だと諦めました。
noteの体験談より
CLAUDE.mdは「守らせる設定」として作られていない
Anthropicの公式ドキュメントは、CLAUDE.mdを“context, not enforced configuration”と説明しています。読み込まれる文脈であって、強制される設定とは書かれていません。1ファイル200行未満が目安ともあります。
つまりCLAUDE.mdが守られないと嘆く前に、確かめる順番があります。書いた中身より先に、各エージェントの設定そのものが今どうなっているか。私はそこを見ていませんでした。
CLAUDE.mdに書いても守られないときに、フックやスキルへ移す手順と、フックが発火しているかの確かめ方は別の記事にまとめました。Claude Codeが言うことを聞かない時の直し方
揃えたはずのモデル指定はなぜずれる?
揃えた日の確認は、その日の状態しか保証しません。2026年9月28日に揃えたはずのモデル指定が、2週間後の10月14日に数え直すと、21本中3本ずれていました。
21本のうち3本がSonnetだった
サブエージェントの定義は、Markdownファイル1枚です。先頭の設定欄にmodel:の行があり、そこで使うモデルを決めます。私はブログ運営用に、この定義を21本作って使っています。
きっかけは、Claude Codeへ投げた次の依頼でした。
sonnet形式のskillsやagentは残ってない?残っていたらopus5.5以降の仕様にして、さらに賢くして。学びがあれば書き換わる仕組みにしてほしい。このやりとりも記事にできるよね
2026年10月14日、筆者がClaude Codeへ送った依頼の原文
数えた結果は、model: opusが18本、model: sonnetが3本。Sonnetだったのは調査担当、心理技法の仕上げ担当、Threads予約の運用担当です。2026年10月14日時点のClaudeの最上位はClaude Opus 5.5なので、この3本だけが下のモデルで動いていたことになります。
自分の公開記事と食い違っていた
ここが一番、恥ずかしいところです。私はClaude CodeでAI社員を20体作った記事に、9月28日時点で20体すべてをopus指定へ揃え、数え直して確かめたと書きました。そのあと数え直したら、ずれていたわけです。
3本をまとめて「戻った」と書くのは誇張になるので、分けて書きます。
- 心理技法の仕上げ担当は、10月7日に新しく作った担当でした。9月28日の20体には入っていません。作ったときからSonnetだったと見られますが、作成時の定義ファイルが残っていないので断定はしません。
- 調査担当とThreads運用担当の2本は、9月28日に揃えた側にいました。それなのにSonnetに戻っていた。なぜ戻ったのかは、記録が残っておらず分かっていません。
原因が分からない2本を、推測で埋めることはしません。分からないまま、どう拾うか。その答えは、このあと点検表の節で出します。
model:の行だけ直しても、古い指定は別の場所に残る
3本のmodel:行を直して終わり、とはいきませんでした。記事づくりの手順書に「調査・心理技法・Threads反映は sonnet」という1行が残っていたのです。モデルの使い分けルール文書も2026-07-06版のままで、最上位は古い世代のOpusに固定、下書きの充填はSonnetと書かれていました。
定義ファイルを直しても、手順書やルール文書に古い指定が残っていれば、次に担当を作るときにまた写されます。新しく作った担当には、同じ指定が自動では入らないからです。
販売している商品に同梱したエージェント6本も、Sonnetのままでした。こちらは購入者の費用に関わるので、変更はまだ判断待ちにしています。スキル側には、そもそもmodel:の指定がありませんでした。
直し方は別名opusで書く
3本は、バージョン番号付きのモデルIDを使わず、別名のopusで書き直しました。公式のモデル設定ページにあるとおり、別名で書いておけば新しいOpusが出たときに書き換えずに上がります。サブエージェントのモデル指定の細かい書き方は、Claude CodeのAI社員の作り方にまとめてあります。
---
name: researcher
description: 記事の調査担当
model: opus
---同時に、3本それぞれに「判断の仕方」の節を足しました。中身は、過去に実際に起きた失敗から書いています。
- 心理技法担当は、足した文で新しい数字が増えていないかを、編集前後の数字の一覧で機械的に比べる。迷う箇所は直さず、候補と理由を報告する。
- Threads運用担当は、予約の補充を回し直すと新記事の割り込みが消えるので、かけ直す。台帳に記録が無いことを、投稿していない証拠にしない。
- 調査担当は、着手前に過去の却下テーマを検索で引く。目安の値を実測として書かない。
サブエージェントに学びを持ち越させるには?学び帳の書き方
サブエージェントに学びを持ち越させるには、エージェント1体ごとに学び帳ファイルを1枚持たせ、起動時に読ませて終了時に1行書かせます。2回起きた学びだけを、エージェント本体の定義へ昇格させる。これがClaude Codeの同じミスを次に持ち越さないために入れた型です。
点検したとき、既存のエージェントに学びを残す仕組みは1つもありませんでした。学び、learnings、lessonsで検索して0件。そこで動画系以外の16本に、1本1ファイルの学び帳を用意しました。写せるものは次の4つです。
写せるもの1 学び帳1行の書式
- [回数:1] 2026-10-14 | 起きたこと | 次からこうする | 根拠根拠の欄には、人からの指摘、コマンドの実測結果、ファイルの場所のどれかを入れます。根拠の無い学びと秘密情報は書きません。「気をつける」で終わる行も不可。次の自分が行動を変えられる形にします。

写せるもの2 1ファイル20行の上限
## 上限
- 1ファイル20行まで
- 同じ学びは行を足さず、[回数:N] を1上げる
- 超えたら、回数1の古い行から消す上限を決めたのは、学び帳そのものが長くなれば、CLAUDE.mdと同じく読まれても効かない文書になるからです。20行は、毎回の起動で全部読んでも重くならない量として私が決めた数字です。
写せるもの3 回数2で本体へ昇格
## 昇格のきまり
- [回数:2] 以上になった行は、エージェント定義の「確定した学び」節へ移す
- 移すのはメインのセッション。エージェント自身には移させない
- 移した行は学び帳から消す1回きりの失敗は、その日の事情かもしれません。2回起きたら、次も起きる前提で本体に入れる。昇格先をCLAUDE.mdにせず、そのエージェント自身の定義にしたのは、関係の無い担当にまで注意書きを読ませたくなかったからです。
写せるもの4 何も無ければ何も出さない通知
セッション開始時(SessionStartフック)に小さなスクリプトを動かし、昇格待ちか上限超過があるときだけ1行知らせます。出力例はこれだけです。
学び帳: threads-ops: 昇格待ち 1 件スクリプトの中身は短くて済みます。私が使っているものを、要点だけ残して縮めると次のとおりです。
import re
from pathlib import Path
LESSONS_DIR = Path(".claude/lessons")
LINE_LIMIT = 20
PROMOTE_AT = 2
ENTRY = re.compile(r"^- \[回数:(\d+)\]")
notes = []
for path in sorted(LESSONS_DIR.glob("*.md")):
counts = [int(m.group(1)) for line in path.read_text(encoding="utf-8").splitlines()
if (m := ENTRY.match(line))]
waiting = sum(1 for c in counts if c >= PROMOTE_AT)
if waiting:
notes.append(f"{path.stem}: 昇格待ち {waiting} 件")
if len(counts) > LINE_LIMIT:
notes.append(f"{path.stem}: {len(counts)} 行で上限 {LINE_LIMIT} 超過")
if notes:
print("学び帳: " + " / ".join(notes))エージェントが1本しか無い人は、学び帳を1枚作り、そのエージェント定義の末尾に「起動時に学び帳を読む。終了時に学びがあれば1行書く」と2行足すだけで始められます。通知スクリプトは、行が増えてからで間に合います。
空のときは黙る通知を3パターンで確かめた
通知スクリプトは、空なら出力なし、昇格待ちが1件なら1行表示、元に戻せば再び出力なし。この3パターンを実際に動かして確かめました。
毎回何かを出す通知は、いずれ読まれなくなる
起動のたびに「学び帳に異常はありません」と出る通知を想像してください。3日もすれば目が滑り、本当に昇格待ちが出た日も読み飛ばします。だから何も無い日は、1文字も出さない作りにしました。
動作確認の結果
- 学び帳が空の状態で実行すると、出力なしで終了コード0。
- テスト用に回数2の行を1行足して実行すると、「学び帳: threads-ops: 昇格待ち 1 件」と表示。
- テスト行を消して元に戻し、再実行すると出力なしに戻った。

フックを足したあとは、設定ファイル(settings.json)がJSONとして壊れていないことも確かめています。編集前には対象ファイルを全部控えました。フックの設定を壊すと、ほかの仕組みまで止まるからです。
揃えた設定のずれはどうやって見つける?点検表4項目
揃えた設定のずれは、model:の行、手順書に残った古い指定、使い分けルール文書の日付、新しく作った担当の4か所を、決まった順に数え直すと見つかります。原因が分からない2本のずれも、この4項目なら拾えます。
前の節で伏せていた答えはここです。なぜ戻ったか分からないなら、戻っても気づける形にしておく。それが私の結論で、見つかった4か所をそのまま点検表にしました。
| 点検項目 | 見る場所 | 私の環境で見つかったもの |
|---|---|---|
| model: の行 | 全エージェント定義の先頭の設定欄 | 21本中3本がsonnet |
| 手順書に残った古い指定 | 記事づくりなどの手順書の本文 | 「調査・心理技法・Threads反映は sonnet」の1行 |
| 使い分けルール文書の日付 | モデルの使い分けを書いた文書の版 | 2026-07-06版のまま |
| 新しく作った担当 | 前回揃えた日より後に作った定義 | 10月7日に作った心理技法担当がsonnet |

数え直しは検索1回で始められる
1項目めは、エージェントのフォルダでmodel:を検索すれば数が出ます。私の場合は、Sonnetの指定が残っていないかをClaude Codeに聞き、数えさせました。2項目めは、手順書やルールのフォルダでsonnetを検索します。直したあとも同じ検索をかけ、販売商品の6本と過去の調査メモの文中だけが残ることを確かめました。
点検はいつやるか
担当を新しく作った日と、新しいモデルが出た日。この2回は必ず回してください。私は使い分けルール文書の点検欄に、担当を足すときの確認として「model: opus か」の1行を入れました。10月7日に担当を1本足した日も、私は数え直していませんでした。
点検表を自分で回すのが面倒なら
上の4項目は、ここまでの手順で誰でも回せます。それでも、AIに作らせたアプリや仕組みが本当に動いているかを人の目で見てほしい人向けに、AIアプリ点検室を開いています。月額980円(税込)で、点検の実録を月2本お届けします。
AIアプリ点検室の内容を見るCLAUDE.mdと学び帳は何が違う?
CLAUDE.mdはプロジェクト全体で読まれる共通の文脈で、学び帳はエージェント1体だけが読む失敗の控えです。読む相手と、書き足す人が違います。
全員に読ませる文書と、1体だけが読む文書
Threads運用担当の失敗を、記事の調査担当が読む必要はありません。CLAUDE.mdに全部足していくと、200行の目安はすぐに越えます。越えた先で起きるのが、冒頭で引いた「全て、守られていない」状態だと私は見ています。
| 比べる点 | CLAUDE.md | 学び帳 |
|---|---|---|
| 読む相手 | そのプロジェクトのセッション全体 | そのエージェント1体だけ |
| 長さの目安 | 1ファイル200行未満(公式) | 1ファイル20行まで(自分で決めた上限) |
| 書く中身 | 全体の決まりごと | 起きたことと、次の行動と、根拠 |
| 育ち方 | 人が書き足す | 回数2で本体の定義へ昇格 |
公式の記憶の仕組みもある
Claude Codeには公式の記憶の仕組みもあります。サブエージェントの公式説明には、セッションをまたいだ学習を有効にするmemory:の項目が載っています。auto memory(MEMORY.md)という自動メモリもあります。私が試したのは自作の学び帳だけなので、ここでは両者の良し悪しは比べません。
Claude Codeの同じミス対策で、まだ分かっていないこと
2026年10月14日時点で、学び帳に書かれた実際の学びは0件です。昇格も1回も起きていない。Claude Codeの同じミスがこれで止まったかどうかは、まだ言えません。
言えることと、言えないこと
言えるのは、仕組みを入れたこと。そして通知が3パターンとも想定どおりに動いたことです。回数2で昇格させる決まりと20行の上限は、私が決めた設計にすぎません。実際に回して確かめた結果は、まだ1つも無い状態です。
3本をOpusに上げたことで、品質や速度がどれだけ変わったかも測っていません。費用の増減も同じです。測っていないものを、良くなったとは書けません。
最初の学びが付いたら、この記事に追記する
16本のどれかに最初の1行が書かれた日、そして初めて昇格が起きた日に、その行の中身をこの記事へ追記します。成果が出るのを待たず、点検の記録として今の時点で出しておく。そのほうが、同じ場所で止まっている人の役に立つと判断しました。
ほかの実録も読みたい人は、AI自動化の実例まとめから入れます。作ったはずのファイルが消えて困った話は、Claude Codeで保存されないときの原因と対処に書きました。プログラミングを知らない状態から仕組みを作った経緯は、非エンジニアのClaude Code自動化の実録にあります。
よくある質問
Claude Codeの同じミスと、サブエージェントの学び帳について、聞かれそうなことをまとめました。
Q1. エージェントが1本しか無くても、学び帳は作れますか?
作れます。Markdownファイルを1枚作り、エージェント定義の末尾に「起動時に読む、終了時に学びがあれば1行書く」と足すだけで始められます。
Q2. Claude Codeの同じミスは、CLAUDE.mdに書き足せば止まりますか?
止まるとは限りません。公式はCLAUDE.mdを強制される設定ではなく文脈と説明しています。先に各エージェントの設定が揃っているかを数え直すのがおすすめです。
Q3. model: opus と書くのと、バージョン付きのIDで書くのは何が違いますか?
別名のopusで書くと、新しいOpusが出たときに書き換えずに上がります。バージョン付きのIDは、書き換えるまでそのモデルに固定されます。
Q4. 揃えたはずのモデル指定がずれる原因は何ですか?
私の環境では、1本は揃えた日より後に作った担当でした。残る2本は記録が無く、原因は分かっていません。だから原因探しより、点検表で定期的に数え直すほうを選びました。
Q5. 学び帳に書いてはいけないものはありますか?
根拠の無い学びと秘密情報です。APIキーや取引先の名前、個人情報は書きません。根拠の欄には、指摘や実測の結果、ファイルの場所を入れます。
Q6. なぜ回数2で昇格させるのですか?
1回きりの失敗は、その日だけの事情かもしれないからです。2回起きたものは次も起きる前提で、エージェント本体の定義へ移します。これは私が決めた設計で、昇格はまだ0回です。
Q7. 通知スクリプトは必須ですか?
エージェントが少ないうちは無くても回ります。学び帳が何枚にも増えたら、昇格待ちを見落とさないために入れると楽です。何も無い日は何も出さない作りにしてください。
Q8. 点検はどのくらいの頻度でやればいいですか?
担当を新しく作った日と、新しいモデルが出た日の2回は必ず回してください。私は担当を1本足した日に数え直さず、その1本はSonnetのまま動いていました。
Q9. 公式のmemory:機能は使えないのですか?
公式のサブエージェント説明に、セッションをまたいだ学習のためのmemory:の項目があります。私は試していないので、比べた結果は書いていません。
AIに作らせた仕組み、このまま動かして大丈夫か不安なら
設定のずれは、作った本人ほど気づきにくいものです。進め方は2通りあります。
作ってほしい方
30分の無料相談
今の業務やシステムのどこから作り直せそうかを、一緒に整理します。見積もりは内容を伺ってからお出しし、頼むかどうかはそのあとで決めていただけます。しつこい営業はしません。
無料相談の内容を見る自分でAIに作らせたい方
AIつまずき相談 90分(16,500円・税込)
画面を共有して、作り始める前に何をどの順で作るかを洗い出します。作ったアプリが本当に動いているかの確認にも使えます。録画と手順メモをお渡しします。
90分相談の内容を見るまとめ|Claude Codeの同じミスは点検と学び帳で次に持ち越さない
Claude Codeの同じミスが戻るとき、書いたルールの中身より先に、揃えたはずの設定がずれていないかを数え直してください。私は9月28日に揃えて記事にも書いたのに、2週間後には21本中3本がSonnetでした。1本は後から作った担当、2本は原因が分からないまま戻っていました。
- model: の行、手順書の古い指定、ルール文書の日付、新しく作った担当の4項目を数え直す
- モデルは別名のopusで書く
- エージェント1体に学び帳を1枚。書式は1行、上限は20行
- 回数2で本体の定義へ昇格。昇格させるのはメインのセッション
- 通知は、何も無ければ何も出さない
ここまで読んだあなたは、ルールを書き足すだけで終わらせない側の人です。次に担当を1本作ったら、その日のうちに点検表の4項目を回す。そう決めておけば、2週間後の私と同じずれは拾えます。学び帳の最初の1行が付いた日に、この記事にも追記します。
追記したときや、新しい実録を出したときは公式LINEでもお知らせしています。
レコプラ公式LINEを見るAIを使った仕事を収入につなげたい人は、Claude Code副業の始め方と単価相場も参考にしてください。
参考資料
この記事を書いた人|ゆうき
中小企業DX化コンサルタント × システム開発者
1987年生まれ。高卒スタートから中小物流会社の業務改善責任者へ。
大手コンサルに頼らず、現場の業務をAIとシステムで組み替えてきました。物流会社に勤めて19年(うちバックオフィス・業務改善15年)。Claude Codeで自作したブログ運営用のサブエージェント21本を、自分で点検しながら使っています。
ゆうきのプロフィールを見る お問い合わせ:info @desire-planet.com
公開日 2026年10月14日 最終更新日 2026年10月14日




