Claude Code の裏で動くエージェント・worktree・/loop を、運営の記録で確かめる:Anthropic の変更履歴を読む
原文の情報
この記事は Anthropic が GitHub で公開している変更履歴を当サイトが読んで解説したものです。Anthropic の公式の翻訳・要約ではなく、Anthropic とは関係がありません。
- 文書の名前
- Changelog
- 公開している所
- anthropics/claude-code
- 版の日付
- 確かめた日
- 読んだ版
- Changelog(github.com)
この記事の下書きには Anthropic の Claude を使っています。AI で下書きし、原文と一次資料を確かめてから公開しています。作り方と決まり
このサイト群は、Claude Code のエージェントが調べ物・サイトの制作・公開前の確認を分担して運営しています。手順の決まりも、うまくいかなかったことの記録も、リポジトリの中のファイルに残しています。
この記事では、Anthropic が GitHub で公開している Claude Code の変更履歴から、運営で使っている機能が足された版を確かめ、記録から数えた結果と並べます。 このリポジトリの LICENSE.md は「All rights reserved」で、使い方は Anthropic の商用の利用規約によるとしています。 そのため、変更履歴の行を引くのは最小限にし、ほかは日本語で短く言い直しています。3行で言うと
-
変更履歴では、裏で動くエージェント、worktree で分けて動かすこと、
/loopによる繰り返しが、それぞれ別の版で足されています。 - このサイト群の QA の記録 161 件のうち、1 回目から残っている 157 件を数えると、最初の回で PASS したのは判定の読める 155 件中 13 件でした。
- 記録に残る失敗の多くは、新しい機能ではなく使い方の決まり (同時に動かす数・止めるプロセス・検査に戻す項目) で直していて、その決まりを書いた文書が運営の中心になっている、というのが当サイトの見立てです。
この記事を読む前に
- サブエージェント:大もとの会話 (このサイト群ではオーケストレーターと呼んでいます) から、役割を決めて起動する別のエージェントです。
- worktree:ひとつの git リポジトリから、別のブランチを別のフォルダーに取り出す仕組みです。並行する作業が、お互いのファイルを書き換えずに済みます。
/loop:同じ指示やスラッシュコマンドを、決まった間隔で繰り返す Claude Code のコマンドです (変更履歴の 2.1.71)。- QA:このサイト群では、作った人とは別のエージェントが、公開の前に中身と検査の強さを確かめる工程を指します。
- 変異テスト:わざと不具合を入れて、テストがそれを見つけて落ちるかを確かめる方法です。
原文の要点
当サイトの要約
- 2.0.60 で、作業を続けている間にエージェントを裏で動かせるようになりました。 2.0.60 が npm に登録されたのは 2025-12-05 (UTC) です。
-
2.1.49 で、Claude Code を別の git worktree で始める
--worktreeと、サブエージェントを一時的な worktree で動かすisolationが足され、2.1.50 でエージェントの定義にもisolation: worktreeと書けるようになりました。 npm への登録は、2.1.49 が 2026-02-19、2.1.50 が 2026-02-20 (どちらも UTC) です。 -
2.1.59 で、役立つ文脈を Claude が自動の記憶 (auto-memory) に保存するようになりました。管理には
/memoryを使います。 2.1.59 が npm に登録されたのは 2026-02-25 (UTC) です。 -
2.1.71 で、指示を決まった間隔で繰り返す
/loopと、セッションの中で繰り返しの指示を予約する cron の道具が足されました。 2.1.71 が npm に登録されたのは 2026-03-06 (UTC) です。 - 2.1.212 でひとつのセッションが起動できるサブエージェントの数に上限 (既定 200) が、2.1.217 で同時に動くサブエージェントの数に上限 (既定 20) が足されました。 npm への登録は、2.1.212 が 2026-07-16、2.1.217 が 2026-07-21 (どちらも UTC) です。
当サイトが足したもの:くらべる
変更履歴の機能と、このリポジトリで近いことをしている所
下の表は、上の要点の機能ごとに、このリポジトリで近いことをしている所を並べたものです。
| 機能 | このリポジトリで近いことをしている所 |
|---|---|
| 役割を決めたサブエージェント | 役割の定義は .claude/agents/ に 7つあり (pm・researcher・site-builder・qa-reviewer など)、オーケストレーターはサブエージェントに、その役割のファイルを最初に読ませます。 |
| 裏で動くエージェント | PM の計画を受け取ると、オーケストレーターはタスクを役割ごとのサブエージェントとして並行して起動します。 |
| worktree | QA の前の新しいページは worktree とブランチ (feat/<id>) で作り、QA を通ってから main にまとめます。QA の前のページを main に置かないためです。 |
| 自動の記憶 | ユーザーの決定のうち手順に効くもの (週の使用率で回す頻度を変えるなど) は記憶のメモに置き、ORCHESTRATION.md からそのメモの名前で指しています。 |
/loop と次の起き上がりの予約 |
オーケストレーターは /loop で 1 回分の手順を繰り返し、最後に ScheduleWakeup で次に起きる時刻を予約します。作業が続くなら 60〜300 秒後、ユーザーの返事を待つだけなら 1800 秒以上後です。 |
| 一回きりの予約 | 動いている作業が無く次の予定が先のときは、1 時間おきの空回りをせず、その日時に CronCreate で一回きりの予約を置いてループを止めます。 |
| 同時に動く数の上限 | Claude Code の上限とは別に、重い検査 (ブラウザのテスト・Lighthouse・変異テスト) を機械全体で同時に 2 本までにする scripts/heavy.sh を、2026-10-12 から使っています。 |
Added `/loop` command to run a prompt or slash command on a recurring interval (e.g. `/loop 5m check the deploy`)
(当サイト訳)/loop コマンドを足した。プロンプトかスラッシュコマンドを、決まった間隔で繰り返し実行する (例:/loop 5m check the deploy)。
変更履歴の例は、決まった間隔で配信を確かめる使い方です。このリポジトリでは間隔を決めず、回ごとに次に起きる時刻を選んでいます。待つものが長いときに、短い間隔で空回りしないためです。
当サイトが足したもの:手元で測った結果
記録から数えた結果
QA の記録 (pm/qa/ の Markdown) と、コミットの履歴を数え直しました。数えるのは決まったコミットの時点の中身なので、後から記録が増えても、下の数は変わりません。
| 数えたもの | 結果 |
|---|---|
| QA の記録のファイル (CHECKLIST.md を除く) | 161 件 |
| 途中の回から始まる記録 | 4 件 (前の回を上書きした記録。最初の回の数から外した) |
| 最初の回で PASS した記録 | 判定の読める 155 件中 13 件 (8.4%) |
| 最初の回で FAIL した記録 | 155 件中 142 件 |
| 最初の回の判定を手で決めた表との一致 | 161 件中 161 件 (表は数え方を直した後に作った)。QA が先に手で見た 22 件では 22 件が一致 |
| 自己点検の決まりの前と後 | 前 (2026-10-17 より前に作った記録) は 102 件中 8 件 (7.8%)、後は 53 件中 5 件 (9.4%) |
| 指摘 (F 番号) | 51 ファイルの 250 件 |
| 検査の強さと中身 | 検査の強さ 120 件 (48%)・中身 130 件 |
| 語の分け方と、手で分けた見本の一致 | 6 ファイルの 37 件中 30 件。外れのうち、中身の指摘を検査の強さに数えたものが 5 件、その逆が 2 件 |
| 変異テストの結果の書き込み | 205 か所に、合わせて「4,149 件中 4,113 件を検出」と書いてあり、検出されなかった 36 件もこの中にある。うち 62 か所は作業者の変異の回し直し。x/y の形で書いていない検出されなかった変異 (名前の列・「生存 N」・表の「生き残り」の列など) は、この合計に入らない |
| コミット | 1,883 件 (2026-10-03〜2026-11-04)。題が QA で始まるもの 264 件、feat・fix のブランチを main にまとめたもの 120 件 |
| 決まりを書いた文書 | CHECKLIST 89 項目、AGENTS.md の学び 350 項目、役割の定義 7つ |
数えた時点は、このサイト群のリポジトリのコミット ccfb53bb (2026-11-04 の main) です。Node.js 26 で動かし、git の中身 (git show と git log) だけを読みます。
このサイト群の手元では、リポジトリの直下で次の命令を動かすと、同じ数が出ます。
node sites/papa-engineer/scripts/techblog-cc-records.mjs --stdout数え方
- 最初の回:記録の最初の見出しから、次の回の見出しまでを最初の回としました。最初の見出しが途中の回から始まる記録は、前の回を上書きしていて最初の回の判定が分からないので外しました。その後の回の区切りは、予定の見出し (「再 QA で見ること」など) と見分けきれなかったので、回の数と平均は出していません。
- 判定:その回で最初に出る「判定:PASS」「判定:FAIL」をその回の判定にしました。「合格」は PASS、「不合格」「失敗」は FAIL に数え、判定の行が読めない回はどちらにも数えていません。記録の頭に最後の判定をまとめた形 (「判定:PASS (再 QA…)」の後に最初の回の FAIL を書く形や、回を名指しした「判定 (N 回目)」) は、名指しした回の判定として読みます。
- 指摘:行の頭が太字の F 番号の行を指摘とし、同じファイルの同じ番号は最初の行だけを数えました。後の回の「直った」の行を数えないためです。
- 検査の強さと中身:指摘の最初の行に「テスト・検査・変異・素通り・生存・見逃・止めない・止まらない・照合・守っていない・通る・通った」のどれかがあれば検査の強さ、無ければ中身 (画面の文・事実・計算・図) としました。
- 最初の回の判定の表:数え方を直した後で、全部の記録の見出しと判定の行を読み、最初の回の判定と始まりの回を手で決めた表を作って照合しました。後から作った表なので、数え方と別に確かめた値として強いのは、QA が先に手で見た記録との一致の方です。
- 見本:papa-techblog の記録では、QA が回ごとに「どれが検査の強さで、どれが画面の誤りか」を書いているので、それを正解にしました。ほかの記録 (cloudnet・small-fixes・links-housoku・vuln-runtime・fermi) は、この記事の QA が手で分けた結果を正解にしました。
- 変異テスト:「何件のうち何件を検出」の形の書き込みを足し合わせました。作業者の変異を QA が回し直した分、直した後に確かめた分も入り、検出されなかった変異を名前で並べた書き方は入りません。
分かったこと
1 回目から残っている記録で、最初の回で PASS したのは判定の読める 155 件中 13 件 (8.4%) で、残りの 142 件は最初の回で FAIL でした。pm/ORCHESTRATION.md の 2026-10-17 の節は「1 作業あたり QA が平均 3〜4 回」と書いています。この記事では回の数を数えていないので、この値とはくらべられません。
作業者が CHECKLIST を全部通してから QA に出す決まり (2026-10-17 から) の前と後で、最初の回で PASS した割合は 7.8% と 9.4% で、この数え方では大きくは変わっていません。ただし、後の時期ほど CHECKLIST の項目が増えて QA が見る範囲も広がっていて、件数も多くないので、決まりが効いたかどうかまでは言えない、というのが当サイトの見立てです。指摘 250 件のうち、検査の強さ (テストやビルドの検査が不具合を止めない) が 120 件 (48%)、中身 (画面の文・事実・計算・図の誤り) が 130 件でした。手で分けた見本との一致は 37 件中 30 件で、外れは両方の向きにあるので、検査の強さの 48% は目安の値です。記録に「何件のうち何件を検出」と書いた箇所は 205 か所で、合わせると 4,149 件中 4,113 件です。この合計は、作業者の変異の回し直しや直した後の確かめを多く含み、検出されなかった変異を名前で並べた記録は入らないので、変異テストの検出率としては読めない、というのが当サイトの見立てです。当サイトが足したもの:小さなチームで試せること
小さなチームで試せること
重い検査は、機械全体で同時に動かす数を決める
並行するエージェントの Chrome が重なり、8 コアの機械で負荷が 49 になって、組み込みに 1〜2 時間かかっていたことがあります (2026-10-12)。それからは重い検査を scripts/heavy.sh で包み、空きが出るまで待ってから動かしています。枠は一時フォルダーの中のディレクトリで、持ち主のプロセスがもう無ければ空きとみなします。それでも 2026-10-27 には、16GB の機械がメモリ不足で再起動しました。再開した後は、並行するエージェントを 3 体まで、重い検査を 1〜2 本に絞っています。2.1.290 では、定期の起き上がり (/loop) を待っている裏のセッションを、更新やメモリ不足のときも止めずに残すように変わりました。2.1.290 が npm に登録されたのは 2026-10-05 (UTC) です。Changed background sessions waiting on a scheduled wakeup (`/loop`): they are now left running through updates and low memory, where being restarted or shut down could silently lose the wakeup
(当サイト訳)定期の起き上がり (/loop) を待っている裏のセッションを、更新やメモリ不足のときも動かしたままにするよう変えた。再起動や終了で、予約した起き上がりが黙って失われることがあったため。
要点の 2.1.217 の上限はサブエージェントの数を決めるもので、それぞれが起動するブラウザやテストの数までは決めないので、機械に合わせた数は自分で決める必要がある、というのが当サイトの見立てです。手元の機械で一度に動かせる重い作業の数を決め、空きが出るまで待つ仕組みは、エージェントでなくても、ビルドの多いチームならそのまま使えるはずです。
止めるのは、自分が起動したプロセスだけ
あるエージェントがpkill -f でテストのファイル名に当たるプロセスを止め、並行していた別のエージェントのテストまで止めたことがあります (2026-10-14)。待つ処理を pgrep -f で書いたら、待っているシェル自身のコマンド行がその文字列を含むので自分自身も拾ってしまい、終わらなかったこともあります (2026-10-21)。テストの終わりを待つだけの裏のループを残したまま報告を終え、それが数日動き続けたこともあり、2026-10-19 にはメモリ不足で 5 体分のエージェントが止められました。今は、止めるのは自分で控えた PID だけにし、待つときは裏で動かしたコマンドの終わりの知らせを使い、報告の前に自分の待ちのループと監視を全部止める決まりです。動かないエージェントを、ファイルの更新時刻で見つける
動いているのに、作業ツリーのファイルが 3.5 時間変わらなかったエージェントがありました (koyou)。オーケストレーターは起きるたびに作業ツリーの最終更新時刻を見て、60 分以上動きが無ければ止め、途中の状態をコミットしてから新しいエージェントに引き継ぎます。画面の表示が「動いている」でも、作業の結果が増えているとは限らないので、結果の側を見る決まりにしています。
指摘を、次の作業の検査に戻す
QA が新しい種類の FAIL を出したら CHECKLIST に 1 項目足し、作業者は QA に出す前にその表の当てはまる項目を全部通して、項目ごとの結果を報告に書きます。それでも、ある作業は QA が 5 回続けて FAIL し (KOUMUIN-bonus、2026-10-28 に公開)、記録には「QA の回が増えるほど「検査の穴」探しに偏る」と書きました。今の目安は QA 2 回で、2 回目に残るのが検査の強さだけなら、PM が確かめて公開します。言い方を止める語の表は言い換えで漏れ続けたので (kanemochi では QA 4 回)、見える文を全部台帳に持ち、台帳に載っていない文があればビルドを止める作りに変えたサイトもあります。言い方の表で止める作りは、次の言い換えで漏れることを前提にしておく方が安全です。
記録を、後から数えられる形で残す
QA の記録は判定の書き方が何通りもあり (「判定:PASS」、「## 判定」の次の行、「合格」など)、回の区切りの見出しも「再 QA で見ること」のような予定の見出しと混ざるので、この記事では回の数と平均を出していません。判定と指摘の番号を、決まった形で書いておくだけでも、後から回数や種類を数え直せます。小さなチームでも、レビューで見つけた穴を「次から機械で止める項目」として 1行ずつ足していくと、同じ指摘を何回繰り返したかを数えられるようになります。
原文を読む順番
出典
確かめた日はどれも 2026年11月5日です。
- Claude Code の CHANGELOG.md(anthropics/claude-code、コミット 646b7418。原文。GitHub から写して読みました)
- 同じリポジトリの LICENSE.md(コミット 646b7418)
- npm の @anthropic-ai/claude-code の版の一覧(版ごとの登録日。registry の JSON の time の欄で確かめました)
- このサイト群の記録:AGENTS.md、pm/ORCHESTRATION.md、pm/LOG.md、pm/qa/、.claude/agents/、scripts/heavy.sh(リポジトリは公開していません。数えた時点はコミット ccfb53bb)
この記事の表は当サイトが作ったもので、原文の図・画像は使っていません。Anthropic のドキュメントのページは、この記事では読んでいません。