Claude Code의 세션 제한을 해결하는 'Relay' 도구 개발
I built "Relay" — when Claude Code hits its rate limit, it hands off your FULL session context to Codex/Gemini/Aider so your work never stops
핵심 요약
Claude Code의 세션 제한 시 컨텍스트를 다른 AI 에이전트로 안전하게 넘겨주는 도구 'Relay' 소개.
- 컨텍스트 유지 — Claude Code의 세션 제한 시 작업 내용을 다른 에이전트로 즉시 전송함
- 다양한 에이전트 지원 — Codex, Aider, Gemini 등 8개 이상의 AI 도구와 호환됨
- Rust 기반 설계 — 4.6MB의 가벼운 바이너리로 100ms 이내에 세션 캡처 가능
- 오픈소스 도구 — Claude Code 툴킷의 일환으로 공개된 오픈소스 프로젝트임
모든 Claude Code 사용자는 이 고통을 압니다: 세션에 깊이 빠져 있고, 45분간의 컨텍스트가 쌓였고, 기능은 절반쯤 완성되었고, 마감 기한은 다가오는데 — 속도 제한(rate limit)이 걸립니다.
당신의 모든 컨텍스트는 사라집니다. Codex나 ChatGPT를 열고 모든 것을 다시 설명하는 데 20분을 허비하게 되죠.
그래서 저는 Relay를 만들었습니다. 명령어 하나면 됩니다:
relay handoff --to codex
이 도구는 Claude의 실제 세션 기록(.jsonl 파일)을 읽고 다음을 추출합니다:
- 전체 대화 내용 (최근 25번의 턴)
- 모든 도구 호출 — Claude가 읽고, 쓰고, 편집한 파일들
- Claude가 겪은 모든 오류
- TodoWrite 상태 (완료된 작업, 진행 중인 작업)
- Git 브랜치, diff, 커밋되지 않은 파일들
- Claude가 내린 주요 결정들
그런 다음, 로드된 모든 컨텍스트와 함께 Codex(또는 8개의 에이전트 중 하나)를 대화형으로 엽니다. 새로운 에이전트가 "컨텍스트가 복구되었습니다. 무엇을 도와드릴까요?"라고 말하면 작업을 계속하면 됩니다.
지원되는 8개 에이전트: Codex, Claude (새 세션), Aider, Gemini, GitHub Copilot, OpenCode, Ollama (로컬), OpenAI API
작동 방식:
- Rust 바이너리, 4.6MB, 100ms 미만의 캡처 속도
~/.claude/projects/JSONL 기록을 직접 읽음- 스피너, 에이전트 선택기, 색상 코딩된 출력을 갖춘 대화형 TUI
--turns 10으로 컨텍스트 양 조절 가능--include git,todos로 포함할 내용 선택 가능- 자동 감지를 위한 PostToolUse 훅
설치:
git clone https://github.com/Manavarya09/relay
cd relay && ./scripts/build.sh
ln -sf $(pwd)/core/target/release/relay ~/.cargo/bin/relay
relay init
GitHub: https://github.com/Manavarya09/relay
npm: npm i @masyv/relay
이것은 제가 만든 Claude Code 툴킷의 4번째 플러그인입니다:
- TokenForge — 실제 AST 파싱을 통해 모든 토큰 소스(코드, 출력, JSON, MCP 스키마)를 압축
