Claude Codeを“社員”にする自動実行ボードの設計図｜claude -pを並列で回す・同じフォルダで衝突させない・要確認で止める【実運用ログ】

2026-10-11 の 14:28、私は自分の作業ボードに1行だけ依頼を書きました。「claude codeを並列で使って」。

それまでは、Claude Code を1つ開いて、頼んで、待って、次を頼む毎日でした。その依頼は18分後に片付きました。ボードに「並列」のつまみができ、依頼を書くと裏で別の Claude Code（claude -p）が勝手に起動して、完了すると自分でボードに結果を書き戻すようになったのです。

それから2日あまり。2026-10-13 の夜の時点で、実行の記録は204回、そのうち完了が191回、止めたものが13回です。1回あたりの平均は約67手。ボードに入った項目は206件で、私が画面の前にいない間にも、記事・教材・出品・調査が進んでいます。

この記事は、その「自動実行ボード」の設計図です。コードは実物（_system/hqlib/console_runner.py と console.py）から抜粋し、実際に起きた失敗と直し方まで書きます。

この記事でわかること

• 「台帳（ボード）・実行係・Claude Code」の3つに分ける設計と、なぜ分けるのか

• 並列数・同じフォルダの数・メモリの空きで、起動を絞る仕組み

• 起動時に渡す依頼文の型（進め方4ステップと「しないこと」）

• 失敗・時間切れ・止めた記録の扱いと、実際に起きた2つの失敗の直し方

• 課金・削除・パスワードだけを人に残す「止める線」の引き方

• 自分で作るときに Claude Code に渡せる指示文（有料部分）

全体の設計図

部品は3つだけです。

1. ボード（台帳）: 1つの JSON ファイル（items.json）。依頼・質問・タスク・アイデアが1件ずつ入る。状態（未着手・進行中・完了・中止）、メモ、実行の状態（run）を持つ

2. 実行係（runner）: ボードを3秒ごとに見て、やるべき項目があれば claude -p を起動する小さなループ。コンソールのサーバーの中のスレッドで動く

3. 別の Claude Code（作業者）: 依頼文を標準入力で受け取り、作業フォルダの CLAUDE.md に従って仕事をし、進捗と完了を自分でボードに書き戻す

流れはこうです。

1. 人がボードに依頼を書く（対象のフォルダと優先度つき）

2. 実行係が拾う。空き枠・同じフォルダの数・メモリの空きを見て、1件だけ起動する

3. 作業者が 着手: … のメモを書き、区切りごとにメモを足し、終わったら done を書く

4. 実行係は出力を見張り、終了したら結果をボードに写す。作業者が書き戻さずに終わったときは、最終報告をメモに残す

なぜ3つに分けるのか

一番大事な決め方は、「進み具合を知っているのは作業者」「プロセスの生死を知っているのは実行係」と分けたことです。

作業者の Claude Code は、console set と console done というコマンドで、自分の進捗をボードに書きます。実行係は作業の中身を一切解釈しません。見るのは「プロセスがまだ動いているか」「出力に result が出たか」だけです。

こうすると、実行係は500行ほどの単純なコードで済みます（ほとんどは見張りと表示用の処理です）。中身が賢くないので壊れにくく、サーバーを再起動しても、実行中のプロセスに繋ぎ直すだけで済みます（起動は切り離しておき、出力はファイルに直接書かせます）。

ここだけで持ち帰れる3つのルール

有料部分に入る前に、自分の環境にそのまま使えるルールを3つ置きます。

• 起動は1回に1件。 実行係のループが1回回るあいだに起動するのは1件だけにします。複数を同時に起こすと、Claude Code のログイン（OAuth）の更新がぶつかって、起動直後に認証エラーで落ちることがありました（実例は有料部分）

• 枠は3段で数える。 全体の並列数、同じフォルダの並列数、メモリの空き。この3つを満たす間だけ起動します。設定の既定は、全体3・同じフォルダ1・空きメモリ800MB以上です

• 止める線は少なく、はっきり。 依頼文の「しないこと」は、課金・購入、削除、パスワードや確認コードの入力、の3つだけにしました。それ以外は確認を取らずに最後までやらせます。迷ったときは、作業者が 要確認: … とメモに書いて終わる。これでボードの「要対応」に上がります