설명
에이전트 워크북은 코딩 에이전트인 Claude Code 또는 Codex와 기본 모델 사이에 위치하는 로컬 프록시입니다. 요청마다 하나의 추가 도구 호출을 추가하여, 모델이 응답하기 전에 생각을 정리할 수 있는 공간을 제공합니다. 여기에는 모델이 내리는 결정, 고려한 대안, 각 옵션의 비용이 기록됩니다. 이 프로젝트의 목표는 개발자가 에이전트의 계획이 실제로 수행하는 것과 일치하는지 확인할 수 있도록 하는 것입니다.
더 읽기
프록시는 Docker Compose를 통해 로컬에서 실행되며, 127.0.0.1:8080에서 대시보드를 노출합니다. 모델이 메모를 작성할 때마다 각 메모가 스트리밍되며, 별도의 CLI 세션은 별도의 행에 유지됩니다. Claude Code는 ANTHROPIC_BASE_URL을 로컬 주소로 설정하여 프록시를 가리키고, Codex는 사용자 정의 모델 제공자를 통해 구성됩니다. 선택적 연속성 모드는 동일한 턴 내에서 이전 메모를 도구 호출 간에 사용할 수 있도록 유지합니다(기본적으로 Codex에 대해 활성화되며, 설치된 Claude Code 버전과 확인된 후 명시적 환경 플래그로 Claude Code에 대해 활성화됨). 세션 수, 메모리 및 유휴 시간 초과에 대한 구성 가능한 제한이 있습니다.
이 프로젝트는 자신의 비용을 명확하게 문서화합니다. 매 턴마다 모델에 추가 호출을 하므로 입력 토큰 사용량이 대략 두 배로 증가하고, 모델이 메모를 계속 작성할 때마다 수백에서 수천 개의 출력 토큰이 추가됩니다. 숨겨진 메모 호출이 완료될 때까지 응답 스트리밍이 시작되지 않으며, 최대 60초가 걸릴 수 있습니다. 또한 워크북 메모는 일반 모델 출력이므로 붙여넣은 API 키나 비밀이 메모에 나타날 수 있다고 경고합니다.
에이전트 워크북은 모델의 보호된 내부 추론을 읽거나 노출하지 않습니다. 메모는 모델이 작성할 수 있는 다른 도구 인수와 동일한 일반 도구 호출을 통해 생성됩니다. 운영자가 아카이브 경로를 설정하지 않는 한 디스크에 아무것도 기록되지 않으며, 프로젝트 문서에서는 사용자가 Anthropic 또는 OpenAI의 모델에서 추론 흔적을 수집하거나 훈련하는 데 사용하지 않도록 명시적으로 요청합니다. Apache 2.0 라이선스 하에 배포되며, 두 회사와의 제휴가 없음을 명시합니다.
이 프로젝트는 Claude Code 또는 Codex를 사용하는 개발자를 위한 소규모 단일 개발자 오픈 소스 프로젝트로, 비기술 사용자용 제품이 아닌 코딩 세션 중 에이전트의 추론을 볼 수 있도록 합니다.
- 카테고리AI 에이전트 빌더
- 요금제오픈소스
- 배포셀프 호스팅
- 플랫폼웹
에이전트 워크북의 핵심 기능
로컬 프록시가 모든 Claude Code / Codex 요청에 "생각을 정리하는" 도구 호출을 추가합니다.
각 메모가 작성될 때 스트리밍되는 실시간 대시보드 (127.0.0.1:8080)
대시보드에서 CLI 세션별로 별도의 행
턴 내에서 이전 메모를 사용할 수 있도록 하는 선택적 요청 간 연속성
구성 가능한 연속성 제한 (세션 수, 메모리 크기, 유휴 시간 초과)
Claude Code (ANTHROPIC_BASE_URL를 통해) 및 Codex (사용자 정의 제공자 구성 통해)와 모두 작동
Docker Compose를 통해 완전히 로컬에서 실행; 구성되지 않는 한 디스크에 아무것도 기록되지 않음
Apache 2.0 오픈 소스 라이선스
에이전트 워크북 시작하기
레포지토리 복제: GitHub에서 프로젝트를 가져옵니다 (softcane/agents-workbook).
프록시 시작: docker compose up -d --build를 실행합니다.
대시보드 열기: 127.0.0.1:8080을 방문하고 탭을 열어 둡니다.
CLI를 프록시로 지정: Claude Code의 경우 ANTHROPIC_BASE_URL을 설정하거나 Codex의 모델 제공자 설정을 구성합니다.
정상적으로 작업: Claude Code 또는 Codex를 사용하고, 그 추론이 대시보드로 스트리밍되는 것을 지켜봅니다.
연속성 활성화 (선택 사항): Claude Code의 도구 호출 간에 메모를 사용할 수 있도록 WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true를 설정합니다.
에이전트 워크북의 사용 사례
- 계획 대 행동 감사
- 코딩 세션 리뷰
- 로컬 디버깅
