Flue TypeScript 프레임워크로 자율 코딩 에이전트 구축하는 방법

Flue는 프로그래머블 하네스 아키텍처를 사용하여 자율 에이전트를 구축하기 위한 TypeScript 프레임워크입니다. 이는 Claude Code 및 Codex와 동일한 패턴입니다. Flue를 사용하면 계획을 세우고, 컨텍스트를 수집하며, 파일을 쓰고, 하위 에이전트를 생성하고, 셸 명령을 실행하는 에이전트를 샌드박스 환경 내에서 모두 정의할 수 있습니다.

주요 기능

에이전트 하네스: 모델(예: Anthropic Claude Sonnet 4-6)과 파일 시스템 읽기/쓰기, grep, glob, bash 실행, 네트워크 액세스 등의 도구를 위한 하네스를 결합합니다.
세션: Claude Code 또는 Codex 세션과 유사하게 작업을 추적하기 위한 지속적인 컨텍스트입니다.
스킬: Valibot을 사용한 런타임 검증과 구조화된 출력을 제공하는 재사용 가능한 워크플로우입니다.
샌드박스: 설정이 필요 없는 내장 가상 샌드박스 또는 자체 원격 샌드박스를 연결할 수 있습니다. 환경 변수와 토큰 노출을 세밀하게 제어할 수 있습니다.
배포: 에이전트를 HTTP 서버로 번들링하여 원격으로 사용하거나, CLI(flue run)를 통해 로컬 작업 및 CI에서 실행할 수 있습니다.

예시: 22줄로 구현한 AI 이슈 트리아지

import type { FlueContext } from '@flue/sdk/client';
import { Octokit } from '@octokit/core';
import * as v from 'valibot';

export default async function ({ init, payload, env }: FlueContext) {
  const { issueNumber } = payload;
  const agent = await init({ model: 'anthropic/claude-opus-4-7' });
  const session = await agent.session();
  const triage = await session.skill('triage', {
    args: { issueNumber },
    result: v.object({
      severity: v.picklist(['low', 'medium', 'high', 'critical']),
      reproducible: v.boolean(),
      summary: v.string(),
    }),
  });
  const body = **Severity:** ${triage.severity}\n**Reproducible:** ${triage.reproducible}\n\n${triage.summary};
  await (new Octokit({ auth: env.GITHUB_TOKEN })).request(
    'POST /repos/{owner}/{repo}/issues/{num}/comments',
    { owner: 'withastro', repo: 'flue', num: issueNumber, body },
  );
}