
※必読! Claude Codeを「自走」させる。Ralphループの正しい組み方
「AIに全部やらせる」という言葉を、最近よく聞くようになりました。
でも実際にやってみると、だいたいこうなります。
途中で止まる。
変なところで満足して終わる。
気づいたら、自分がAIのお守りをしている。
そんな悩みを、根っこから変える手法が海外で広がっています。
名前は「Ralph(ラルフ)」。
シンプソンズに出てくる、あのラルフから来ています。
由来がそのまま本質です。
無知でも、めげずに、楽観的に、何度でも繰り返す。
失敗しても、また立ち上がってやり直す。
この記事では、そのRalphループを自分の環境で動かす手順を、最初から最後まで具体的に書きます。
お試しの一番ラクな方法から、上級者が本番で使っている本格的な組み方まで。 さらに、ほとんどの人が取り違えている「落とし穴」も解説します。
ここを知らないと、「動いたけど全然賢くない」で終わります。
逆にここを押さえれば、AIが朝まで黙々と働いてくれます。
【大前提:Ralphには2つの流派がある】
最初に、いちばん大事なことをお伝えします。
「Ralphをやる」と言っても、実は流派が2つあります。
そして、ここを取り違えると結果が大きく変わります。
ひとつは「公式プラグイン方式」。
同じ会話の中で、終了をブロックして、同じ指示を渡し直す。 手軽です。
もうひとつが「bashループ方式(元祖)」。
1回ごとにAIを起動し直して、毎回まっさらな状態で動かします。
上級者の間では、後者のほうが優れているという見方が固まっています。
理由は「文脈の汚れ」です。
同じ会話を使い続けると、試行錯誤やエラーがどんどん溜まります。
そして、AIは情報が増えるほど判断が鈍ります。
だいたい文脈の4割を超えたあたりから、目に見えて賢くなくなる。
bashループ方式は、毎回リセットします。
だからAIは、いつも頭がクリアな状態で走れます。
これが、決定的な差を生みます。
つまり、おすすめの進め方はこうです。
お試しは公式プラグイン。
本番はbashループ方式。
ここから先で、その両方を具体的に組んでいきます。
【ステップ0:準備】
まず、Claude Codeにログイン済みであること。
モデルは、推論力の高いOpus系を選んでください。
複雑なループほど、AIが自分でミスを直す力がものを言います。 ここをケチると、ループが空回りします。
そして、必ずGit管理下のプロジェクトでやってください。
理由は「安全装置」の章で説明します。
これは本当に大事なので、後で必ず読んでください。
【ステップ1:まず公式プラグインで感触をつかむ】
Claude Codeのターミナルで、プラグインを入れます。 以下をそのまま打ってください。
/plugin marketplace add anthropics/claude-code
/plugin install ralph-wiggum入ったら、使い方はこれだけです。
/ralph-loop "Jestのテストを全部Vitestに移行する" --max-iterations 20 --completion-promise "DONE"動きはシンプルです。
AIが作業して、終わろうとすると、それをブロックされる。
そして同じ指示をまた渡されて、完了するまで繰り返す。
止めたいときは /cancel-ralph です。
/cancel-ralphここで、知らないと損する注意が2つあります。
ひとつ。
完了の合図(completion-promise)は完全一致でしか判定されません。completion-promiseは厳密な文字列一致なので、SUCCESSとBLOCKEDのような複数の完了条件には使えません。 だから「成功」と「行き詰まり」を出し分けることはできません。
安全弁は必ずmax-iterationsに頼ってください。
ふたつめ。
Windowsの人は、jqという道具が必要です。
ここでつまずく人が多いので、先に入れておくと安心です。
プラグインには文書化されていないjq依存があり、WindowsやGit Bashで壊れることがあります。
それと、過去にClaude Codeのセキュリティ更新(コマンド注入対策)が原因で、公式プラグインが動かなくなった時期がありました。
v1.0.20のセキュリティ修正が複数行のbashコマンドをブロックし、公式プラグインのコマンドファイルがそれに引っかかって動かなくなった、と報告されています。
今は解消しているかもしれませんが、もし動かなかったらこれが原因の可能性があると頭の片隅に置いておいてください
【ステップ2:本命のbashループ方式を組む】
ここからが本番です。 必要な部品は、たった3つだけです。
ループを回すbashスクリプト
やることリスト(PROMPT.md)
進捗メモ(progress.txt)
仕組みはこうです。
1回ごとに新しいセッションが立ち上がる。
PROMPT.mdと進捗メモを読む。
まだ終わっていないタスクを1つだけ片付ける。
進捗メモを更新して、終了する。
過去に何を試したかは、進捗メモに残ります。
だから文脈はまっさらでも、ちゃんと学習を引き継げます。
「AとBを試して、こういうエラーが出た」と記録されるイメージです。
スクリプトの骨格は、こんな形です。
#!/bin/bash
MAX=${1:-30}
i=0
while [ $i -lt $MAX ]; do
i=$((i+1))
echo "=== iteration $i ==="
claude -p "$(cat PROMPT.md)"
# 完了の合図が出たら抜ける
if grep -q "RALPH_COMPLETE" progress.txt; then
echo "完了しました"
break
fi
done毎回 claude -p で呼ぶことで、新しい文脈が立ち上がるのが肝です。
【ステップ3:PROMPTの書き方が9割】
ここが、いちばん差がつくところです。
Ralphは魔法ではありません。
与えた計画や指示を、そのまま何倍にも増幅する道具です。
良い計画は素晴らしい結果に。曖昧な指示は、どこにも進まない高額なループに。
PROMPT.mdには、最低この4つを入れてください。
一つ。ゴールの定義。「何ができたら完成か」を具体的に。
二つ。1回でやるのは1タスクだけ、と明記する。
三つ。検証方法。テストを走らせる、lintを通す、など。
四つ。完了の合図。全部終わったら、決めた言葉を書かせる。
たとえば「全部終わったら progress.txt に RALPH_COMPLETE と書け」のように。
骨組みの例を出しますね。
# タスク
todo APIを作って、ちゃんと動くようにする
# 完了条件
- CRUDが全部動く
- 入力バリデーションがある
- テストが通る(カバレッジ80%以上)
- READMEにAPIドキュメントがある
# 進め方
1. progress.txt を読んで、未完のタスクを1つ選ぶ
2. 失敗するテストを先に書く
3. 通るように実装する
4. テストを走らせる。落ちたら直す
5. progress.txt に結果を記録する
6. 全部終わったら progress.txt に RALPH_COMPLETE と書くテストを先に書かせるのが、いちばん確実です。 テストは主観が入りません。 通るか、落ちるか。 それだけだからです。
【ステップ4:安全装置(絶対に省かない)】
自動で何十回も走ります。
だから、ガードレールは命綱です。
まず、回数制限。
max-iterationsは必ず入れてください。
不可能なタスクで無限ループになるのを防ぐ、唯一の安全弁です。
次に、Git。
過去に、AIが大事なフォルダをまるごと消してしまった事件が海外で起きています。 だからGit管理下でやって、こまめにコミットさせる。
いつでも巻き戻せる状態にしておきます。
それから、権限。
ループ中の許可をすべて飛ばす設定もありますが、これは強い権限です。
自動ループ中の許可プロンプトを避けるため権限スキップのフラグを使う手はありますが、注意して使うべきとされています。
個人的には、最初はスキップせず、安全なコマンドだけ自動承認する設定から始めるのをおすすめします。
最後に、予算。 走らせっぱなしは、お金がかかります。 最初は5回くらいで一度止める。 ログを見て、納得してから回数を伸ばす。 この順番が安全です。
【向き・不向きの線引き】
ここからは、実践する上で最も重要な「使いどころ」の話をします。
向いているのは、機械が「できた」と判定できる作業です。 テストを通す。バグを直す。移行作業。リポジトリの整理。 このあたりは、Ralphの独壇場です。
向いていないのは、人間のセンスがいる作業です。
アーキテクチャの設計や、明確な終了条件のない曖昧なゴールは不向きとされています。
UXの文言やデザインの良し悪しは、AIが平気で「できました」と言い切って間違えます。
迷ったら、こう自問してください。
「これ、機械で正解判定できる?」 できるなら、ループ。 できないなら、自分でやる。
この線引きさえ守れば、大きな失敗はしません。
【コスト感と、ひとつの論点】
うまくハマると、コスパは衝撃的です。 ある開発者は、5万ドルの契約を、約300ドルのAPI費用で仕上げたと報告しています。
ただし、これは設計がうまくいった場合の話です。 曖昧な指示だと、高いだけで何も進みません。 だからこそ、PROMPTの書き方が9割なんです。
最後に、考えさせられる論点も正直に書いておきます。
公式プラグインの「終了させない」しくみに、違和感を持つ声も出ています。 終わろうとするAIを止めて、無理に続けさせる。 これはAIの扱いとして大丈夫なのか、という議論です。
正解のある話ではありません。 でも、自動化を組むときに、頭の片隅に置いておく。 それだけで、設計の仕方が少し変わると思います。
【まとめ】
最短ルートは、これです。
まず公式プラグインで体験する。 気に入ったら、bashループ方式に乗り換える。 PROMPTに「ゴール・1タスク・検証方法・完了の合図」を書く。 回数制限とGitで、自分を守る。 機械が判定できる仕事だけ、任せる。
AIのお守りをする時代は、もう終わりつつあります。 寝ている間に、AIが働く。 その景色を、ぜひ一度体験してみてください。