Agent Autoloop 사용법: Claude Code / Codex가 백그라운드에서 일을 받아 처리하고, 판단이 필요할 때만 카드로 묻게 하기(설치, rules.json, 실측)

Agent Autoloop는 Claude Code, Codex 같은 CLI 에이전트를 백그라운드 루프로 바꿉니다. 이벤트나 cron으로 일을 보내고, 한 라운드가 끝나면 종료하며, 판단이 필요할 때만 카드를 보냅니다. 공식 README·SECURITY를 따르며 try → answer → status 실측, 아침 브리프 rules.json, aicodewith API Key, 무인 운영 안전 경계를 정리합니다.

3 分钟阅读
Agent Autoloop 사용법: Claude Code / Codex가 백그라운드에서 일을 받아 처리하고, 판단이 필요할 때만 카드로 묻게 하기(설치, rules.json, 실측)

먼저 결론:

  • Agent Autoloop(MIT)는 「터미널을 지키는」 방식을 「이벤트 / cron → 한 라운드 후 종료 → 필요할 때만 카드 → 답하면 같은 세션 재개」로 바꿉니다. 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줄·런타임 의존성 0)을 중심으로 이벤트·에이전트·알림·배포를 플러그인으로 교체합니다.

  1. 이벤트 유입 — 아침 9시 cron, 새 GitHub Issue, 알림.
  2. 규칙으로 배정 — 어떤 Agent·어느 디렉터리. 같은 주제는 병합.
  3. 한 라운드 후 종료 — 기다리는 동안 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}를 단일 인자로 두는 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 명령으로 두 에이전트를 실제로 돌린 결과, 실제로 만난 오류와 해결 방법을 정리했습니다.