릴레이: 클로드 코드 세션을 다른 AI 에이전트로 넘겨주는 도구

Relay는 Claude Code 사용자들이 자주 겪는 문제를 해결하는 도구입니다: 세션이 속도 제한에 도달하면 전체 컨텍스트가 사라져 사용자들이 다른 에이전트로 다시 시작해야 합니다. Relay는 세션 컨텍스트를 캡처하여 다른 AI 에이전트로 넘겨주어 작업이 중단 없이 계속될 수 있게 합니다.

작동 방식

Relay는 ~/.claude/projects/ JSONL 파일에서 Claude Code의 세션 기록을 직접 읽는 Rust 바이너리(4.6 MB)입니다. 다음을 추출합니다:

• 전체 대화(기본적으로 최근 25회)
• 모든 도구 호출—Claude가 읽고, 쓰고, 편집한 파일들
• Claude가 마주친 모든 오류
• TodoWrite 상태(완료된 작업과 진행 중인 작업)
• Git 브랜치, diff, 커밋되지 않은 파일들
• Claude가 내린 주요 결정들

그런 다음 새로운 에이전트와 상호작용 세션을 열어 복원된 컨텍스트를 인지하고 다음 단계를 묻습니다.

사용법과 기능

기본 명령어는:

relay handoff --to codex

추가 옵션으로는:

• --turns 10으로 전송할 대화 컨텍스트 양 조절
• --include git,todos로 특정 컨텍스트 요소 선택
• 속도 제한 자동 감지를 위한 PostToolUse 훅

Relay에는 스피너, 에이전트 선택기, 색상 구분 출력이 포함된 대화형 TUI가 있습니다. 캡처 시간은 100ms 미만입니다.

지원 에이전트

Relay는 8개의 에이전트를 지원합니다:

• Codex
• Claude(새 세션)
• Aider
• Gemini
• GitHub Copilot
• OpenCode
• Ollama(로컬)
• OpenAI API

설치

다음 방법으로 설치하세요:

git clone https://github.com/Manavarya09/relay
cd relay && ./scripts/build.sh
ln -sf $(pwd)/core/target/release/relay ~/.cargo/bin/relay
relay init

또는 npm으로: npm i @masyv/relay

배경

Relay는 저자의 Claude Code 도구 모음에서 네 번째 플러그인으로, TokenForge(AST 파싱을 통한 토큰 압축)와 SecretScan(47가지 패턴의 비밀 탐지기)도 포함합니다. 모든 도구는 오픈 소스이며 Rust로 작성되었습니다.