メインコンテンツへスキップ
見出し画像

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つだけにしました。それ以外は確認を取らずに最後までやらせます。迷ったときは、作業者が 要確認: … とメモに書いて終わる。これでボードの「要対応」に上がります

    あなたへのおすすめ