로컬에서 AI 멀티 에이전트 만들기 (1) — 설계와 환경 구성

사용자: "React로 TODO 앱 만들어줘"
  │
  ▼ task.created
  │
  ├─ PlannerAgent → 구현 계획 JSON
  │
  ▼ plan.completed
  │
  ├─ CoderAgent → 실제 코드 작성
  │
  ▼ code.completed
  │
  ├─ ReviewerAgent → 리뷰 + 점수
  │
  ▼ review.completed → 결과 출력

git clone https://github.com/codemon-ai/agent-basic.git
cd agent-basic
npm install

docker compose up -d

services:
  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

cp .env.example .env

ENGINE_TYPE=claude-cli        # 또는 anthropic-api
ANTHROPIC_API_KEY=sk-ant-...  # API 엔진 사용 시
REDIS_URL=redis://localhost:6379

// src/engines/types.ts
export interface AgentEngineResult {
  result: string;
  session_id: string;
  num_turns: number;
  duration_ms: number;
  cost_usd: number;
}
 
export interface AgentEngineRunOptions {
  cwd: string;
  timeoutMs?: number;
  disallowedTools?: string[];
  onProgress?: (message: string) => void;
}
 
export interface AgentEngine {
  name: string;
  run(prompt: string, options: AgentEngineRunOptions): Promise<AgentEngineResult>;
}

// src/engines/claude-cli-engine.ts (핵심 부분)
const child = spawn("claude", [
  "-p",
  "--dangerously-skip-permissions",
  "--output-format", "json",
], { cwd, env });
 
// 프롬프트는 stdin으로 전달 (ARG_MAX 회피)
child.stdin.write(prompt);
child.stdin.end();

// src/engines/anthropic-api-engine.ts (핵심 부분)
const stream = this.client.messages.stream({
  model: this.model,
  max_tokens: 4096,
  messages: [{ role: "user", content: prompt }],
});
const response = await stream.finalMessage();

// src/engines/index.ts
export function createEngine(type: EngineType, options?): AgentEngine {
  switch (type) {
    case "claude-cli": return new ClaudeCliEngine();
    case "anthropic-api": return new AnthropicApiEngine(options?.apiKey);
  }
}