고급 코딩 모델은 설계와 보안 판단에 유용하지만, 문서 검색이나 제한된 테스트 작성까지 모두 같은 비용으로 처리하면 낭비가 커진다. CodexSaver는 Codex 앞에 붙이는 MCP 라우터로, 아키텍처·보안·최종 검토는 Codex에 남기고 반복적이고 검증 가능한 실행은 저비용 워커 모델 또는 로컬 에이전트에 위임한다.
라우팅 원칙
| Codex에 남기는 작업 | 워커에 맡기기 좋은 작업 |
|---|---|
| 인증·권한·결제·보안 변경 | 코드 설명과 저장소 검색 |
| 모호한 아키텍처 판단 | 문서와 README 보완 |
| 파괴적 마이그레이션 | 범위가 좁은 테스트 생성 |
| 검증이 약한 다중 파일 수정 | 허용 파일이 정해진 작은 패치 |
검증 가능한 위임
CodexSaver의 핵심은 단순히 싼 모델을 호출하는 것이 아니라 작업 경계를 기계적으로 확인하는 데 있다. 작업 패킷(work packet)은 목표, 허용 파일, 금지 경로, 합격 조건, 실행할 검증 명령, 최대 diff 크기를 포함한다. 워커가 만든 패치는 임시 샌드박스에 적용되고 정책과 검증 명령을 통과해야 결과로 돌아온다.
최신 README는 v3에서 Pi Agent 기반의 읽기 전용 전문 에이전트 오케스트레이션을 기본 성공 영역으로 제시하고, DeepSeek 등 프로바이더 기반 위임은 기존 경로로 유지한다고 설명한다. 프로젝트가 보고한 비용 절감 수치는 제한된 자체 벤치마크 결과이므로 실제 저장소에서 별도 측정이 필요하다.
언제 유용한가
- Codex를 주 모델로 사용하면서 리포지토리 검색과 문서화 비용을 낮추려는 개발자
- 허용 파일과 검증 명령을 명확히 정의할 수 있는 반복 패치 작업
- 워커 결과를 자동 반영하지 않고 Codex의 최종 리뷰를 유지하려는 팀
관련 문서
- codex — Codex 작업 환경과 권한 모델
- mcp — CodexSaver가 도구로 연결되는 표준 프로토콜
- agent-harness — 라우팅과 검증 루프를 포함한 에이전트 하네스 설계
참고 자료
- fendouai/CodexSaver — GitHub 공식 저장소