Agent Autoloop の使い方:Claude Code / Codex にバックグラウンドで仕事を取らせ、判断が必要なときだけカードで聞く(インストール、rules.json、実測)

Agent Autoloop は Claude Code や Codex などの CLI エージェントをバックグラウンドループにします。イベントや cron で仕事を渡し、1 ラウンド終えると終了し、判断が必要なときだけカードを出します。公式 README と SECURITY に沿い、try → answer → status の実測、朝のブリーフ rules.json、aicodewith API Key、無人運用の安全境界をまとめます。

3 分钟阅读
Agent Autoloop の使い方:Claude Code / Codex にバックグラウンドで仕事を取らせ、判断が必要なときだけカードで聞く(インストール、rules.json、実測)

先に結論:

  • Agent Autoloop(MIT)は「端末を見守る」を「イベント / cron → 1 ラウンドで終了 → 必要なときだけカード → 回答で同じセッション再開」に変えます。README は macOS / Linux。Windows 公式は未定(issue #17、当面は WSL2)。
  • インストール:curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh、その後 agent-autoloop try。
  • 2026 年 11 月 6 日、Linux で実測:Node 24.22.2、agent-autoloop v1.5.0、Codex(aicodewith、gpt-6.1-sol)。承認ループ成功 — 色カードまで約 9 秒、「緑」回答後同じセッションで約 10 秒「試走通過」。GUI なしで notify-send 欠如、CLI で完走。
  • ルールは ~/.agent-autoloop/rules.json。agent-autoloop check で検証。
  • 無人運用はローカル権限そのもの。カードリンクを外に出さない。Webhook は認証。SECURITY によればプロンプト注入は未解決部分あり。既定は edit、副作用は ask。

API Key を作り、Claude Code / Codex をつないでループを始める →

何を解決するか

Claude Code や Codex は、端末を見ながらの使い方が多いです。窓を閉じると止まります。

Agent Autoloop は決定的な kernel(README 上およそ 1650 行・実行時依存ゼロ)を中心に、イベント・エージェント・通知・配信をプラグインで差し替えます。

  1. イベント到来 — 朝 9 時の cron、新しい GitHub Issue、アラート。
  2. ルールで配布 — どの Agent・どのディレクトリか。同じ件名は合流。
  3. 1 ラウンドで終了 — 判断待ちのあいだ Agent プロセスは動かない。
  4. 必要なときだけカード — 削除・再起動・外向き送信など。
  5. 回答で再開 — 元の会話を続ける。

README によれば Claude Code / Codex / ACP は複数ターンとセッション継続を実測済み。Feishu は実配信あり。Webhook 等はローカル mock 中心。

前提

項目要件
OSmacOS / Linux。Windows 公式は未定(#17)。INSTALL に WSL2
ランタイムNode.js 24+、Git、curl
Agent利用可能な Claude Code または Codex(command でも可)
aicodewith Key(任意)登録して API Key 作成

当機は Node 22 → n 24 で 24.22.2。

手順 0:API Key

  1. aicodewith.ai で登録し「キー管理」。
  2. 「キー作成」、分かりやすい名前(例 autoloop-box)。
  3. すぐ全文をコピー。Create API Key ドキュメント。

API Key を作成 →

Codex — ~/.codex/config.toml:

toml
model = "gpt-6.1-sol"
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

Claude Code — ~/.claude/settings.json:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

関連:Codex インストール、Codex API Key、config.toml、Claude Code バックグラウンドサブエージェント、Conductor 代替 worktree。

インストール

bash
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

本体は ~/.agent-autoloop/app。CI / ヘッドレスは --no-service のあと agent-autoloop up(INSTALL)。

実測(2026-11-06、Asia/Shanghai):v1.5.0(f211ca2de3b1)、Agent は Codex。

bash
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try

最小ループ:try → answer → status

Codex のタイムライン(UTC+8):

手順時刻結果
try15:25:01 → 15:25:10約 9 秒、色カード
answer 1 215:25:27緑、第 3 ラウンド、同一セッション
完了15:25:27 → 15:25:37約 10 秒、「試走通過」
通知—notify-send なし。CLI OK
bash
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3

正直な記録: 初回 try はモデル名が本サイトに無く失敗。gpt-6.1-sol に変更後に成功。Claude Code 単体スモーク約 6 秒で OK。今回の try は Codex プラグイン。

rules.json

朝のブリーフ(README):

json
{
  "name": "Morning brief",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "Summarize yesterday's notes and commits into today's brief."
}

check OK。rules explain は Asia/Shanghai、次回 11/07 09:00。GitHub issues 例はリポジトリ。

Claude Code / Codex / その他

use は claude / codex / acp / dsh、または {prompt} を 1 引数にする command。Claude Code / Codex / Cursor は並列の選択肢。worktree 並列はConductor 代替。

安全

SECURITY より:ローカル権限、カードリンクは 7 日・所持即回答、イベントは Agent を指名できない、Webhook 認証、CLI ログインは中継しない、計測後に Key 設定を削除。

FAQ

Windows? 未定(#17)、WSL2 あり。サービス必須? いいえ。try 失敗? doctor、Node ≥ 24、モデル一覧、完全な experimental_bearer_token。

まとめ

Node 24 → インストール → try / answer / status → cron ルール → SECURITY → Key を消す。

API Key を作り、最初のバックグラウンドルールを書く →

相关文章

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK は、Vercel が 2026 年 11 月 12 日に公開した Agent 向けの振る舞い(behaviors)ライブラリで、バージョンは 0.1.0-beta.1 です。振る舞いはフレームワーク非依存の @ui-sdk/core にあり、React、Vue、Svelte、Solid、Web Components のアダプターが描画します。公式ドキュメントに沿って「何か」「どう入れるか」「Claude Code / Codex / Cursor に skill をどう渡すか」を整理し、テスト機で実際に走ったコマンド、所要時間、出力を記録します。

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator は AWS 公式のローカル AWS エミュレーターで、2026 年 11 月 11 日(米国時間)に一般提供(GA)が始まりました。追加のサービス料金はかからず、ソースは公開されており、AWS アカウントも不要で、200 以上のサービスをカバーします。本記事では Debian 13 上で 1.0.322 を検証し、インストールコマンド、AWS CLI をローカル endpoint に向けて S3 バケットと DynamoDB テーブルを作る手順、遭遇したエラー、Claude Code・Codex・Cursor にエミュレーター相手でコードを書かせてテストさせる方法をまとめます。

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code は pingdotgg が公開しているオープンソースのコーディングエージェント用コンソールです。モデルは内蔵しておらず、マシンにインストール済みの Claude Code、Codex、Cursor などの CLI を操作します。Linux 上で T3 Code 0.1.9 を検証し、インストールコマンド、Claude Code と Codex を AICodeWith API Key につないで T3 Code から操作する設定、t3 thread コマンドで両方を動かした結果、実際に出たエラーと対処法をまとめました。