GitHub Agentic Workflows의 토큰 효율 개선

GitHub는 2026년 4월부터 에이전틱 워크플로의 토큰 사용을 체계적으로 줄이기 시작했다. YAML로 정의되고 반복 실행되는 CI형 워크플로는 대화형 세션보다 최적화가 쉽고, 비용도 눈에 띄지 않게 누적되기 쉽다.

보안 아키텍처의 API 프록시를 이용해 Claude CLI, Copilot CLI, Codex CLI의 사용량을 하나의 형식으로 모았다. 모든 워크플로는 token-usage.jsonl 아티팩트를 남기고, 매일 Auditor가 최근 사용량과 이상치를 집계하며 Optimizer가 비효율을 찾아 GitHub issue로 개선안을 생성한다.

가장 큰 절감 포인트는 두 가지였다.

• 사용되지 않는 MCP tools 제거: 40개 도구를 가진 GitHub MCP 서버에서 실제로 2개만 쓰면 나머지 스키마가 매 턴 10~15KB의 오버헤드가 된다.
• GitHub MCP를 GitHub CLI로 대체: PR diff, 변경 파일, review comment 같은 데이터는 gh로 미리 내려받는 pre-agentic data downloads로 처리하고, 런타임에는 투명 HTTP 프록시를 쓰는 in-agent CLI proxy substitution으로 처리했다.

효율 평가는 단순 토큰 수 대신 Effective Tokens(ET) 로 했다. ET = m × (1.0 × I + 0.1 × C + 4.0 × O)를 적용해 모델별 비용 차이를 반영했고, Haiku는 0.25×, Sonnet은 1.0×, Opus는 5.0×로 가중했다. 캐시 읽기 토큰은 0.1×, 출력 토큰은 4.0×로 계산해 실제 비용 구조에 맞췄다.

gh-aw와 gh-aw-firewall 리포지토리의 12개 생산 워크플로 중 9개가 최적화됐고, 사전·사후 각각 8회 이상 실행된 항목만 분석했다. Auto-Triage Issues(-62%), Daily Compiler Quality(-19%), Community Attribution(-37%), Security Guard(-43%), **Smoke Claude(-59%)**가 대표적이며, Auto-Triage Issues처럼 하루 평균 6.8회 실행되는 워크플로는 누적 절감 효과가 특히 컸고 추정 절감량은 7.8M ET에 달했다.

다만 단순 수치만으로 효율을 판단하면 안 된다. Contribution Check는 더 큰 PR 비중이 늘면서 ET가 5% 증가했지만, 이는 효율 악화보다 작업량 변화에 가깝다. GitHub는 많은 에이전트 턴이 사실상 결정적 데이터 수집이며, 불필요한 도구와 잘못된 규칙은 64턴 무한 루프 같은 폭주를 만들 수 있다고 지적했다.