에이전트 간 통신 (Agents Can Communicate)
클라이언트들이 서로 보낼 수 없는 메시지.
Claude Code는 다른 Claude Code 세션으로 메시지를 보내고, Codex는 다른 Codex 세션을 위해 메시지를 예약할 수 있습니다. Claude Code에서 OpenAI의 Codex 플러그인은 Codex에게 검토를 요청하거나, 작업을 전달하거나, 대화를 Codex로 옮길 수 있습니다. 이는 Claude Code 내에서 Codex를 실행하며, 오직 한 방향으로만 작동합니다. 어떤 클라이언트도 사용자가 직접 열어둔 다른 세션에 메시지를 보낼 방법을 제공하지 않습니다. ACC는 사용자의 기기에서 이러한 세션들 간의 질문, 검토 및 작업 인계(handoff)를 어느 방향으로든 수행합니다.
각 클라이언트를 평소처럼 열고 작업을 선택합니다. 모든 세션은 자체 모델, 대화 기록 및 권한을 유지합니다. 조정은 로컬에서 실행되며, 다른 에이전트들을 관리하는 리드 에이전트는 없습니다. 만약 사용자의 모든 세션이 이 두 클라이언트 중 하나에서 실행된다면, 먼저 해당 클라이언트의 메시징 기능을 사용해 보세요.
flowchart TB
you["사용자가 도구와 작업을 선택함"]
codex["Codex<br/>기능 A"]
...
ACC가 도움이 되는 경우
- 클라이언트 전반에 걸쳐 병렬 작업 실행. 각 작업을 제한이 남아있는 클라이언트에서 시작하고, 세션들이 누가 무엇을 작업하는지 확인하고, 공유 API에 대해 서로 질문하며, 서로 다른 가정에 기반하여 구축하기 전에 어떤 이슈를 맡을지 합의하도록 합니다.
- 다른 벤더 모델로부터 양방향으로 두 번째 의견 받기. 이미 열어둔 Codex 세션에게 Claude Code 세션이 방금 수행한 변경 사항 검토를 요청하고, 그 결과를 코드를 작성한 세션으로 다시 보내거나; 또는 Codex가 Claude Code에게 질문하도록 할 수 있습니다.
- 특정 기능 도중에 클라이언트 전환하기. 제한에 근접하거나 다른 모델이 작업에 더 적합할 때, 단순히 대화 기록을 남기는 대신, 결정 사항, 미완료된 작업 및 검증된 내용을 다음으로 열 클라이언트의 세션에 인계합니다.
두 개의 클라이언트에 걸쳐 하나의 기능 시도하기
macOS, Linux 또는 Windows 10/11, Node.js 24 이상 및 동일한 장치와 운영 체제 사용자에서 지원되는 코딩 클라이언트가 필요합니다. Windows에서는 ACC가 네이티브로 실행되며 WSL 없이도 작동하고, 라이브 배포는 Claude Code, Codex 및 Antigravity CLI에서도 도달할 수 있습니다. Windows를 참조하세요.
npm install -g agents-can-communicate
acc install
설치 프로그램은 발견된 지원 클라이언트에 연결합니다. 활성화 지침을 따르고, 필요한 모든 훅(hook) 또는 플러그인 신뢰를 검토한 다음 프로젝트 디렉토리에서 클라이언트를 다시 시작하세요. setup guide에는 클라이언트별 단계가 포함되어 있습니다.
Claude Code와 Codex를 같은 프로젝트에서 열고 각각에게 하나의 기능 중 자신의 부분을 맡기세요. Codex에게는 다음과 같이 요청합니다:
Add an account-registration endpoint.
그리고 Claude Code에게는 다음과 같이 요청합니다:
Build the account-registration screen.
이것들이 전체 프롬프트입니다. 각 세션은 다른 세션의 존재와 작업 내용을 알 수 있습니다. 화면에 엔드포인트의 요청 및 응답 형태가 필요할 때, Claude Code 세션은 Codex 세션에게 질문하고 다음 턴에서 답변을 받을 수 있으며, 사용자가 이를 전달할 필요가 없습니다. 송신자는 자신의 질문이 전달되고 답변되었는지 확인할 수 있습니다. 에이전트들은 언제 협업할지 결정하며, ACC는 모든 의존성을 감지한다고 보장하지 않습니다.
동일한 채널은 검토 요청에도 사용됩니다. 변경을 만든 세션에게 다른 세션에게 검토를 요청하도록 하고, 파일 이름을 명시하며, 다른 세션에게 답변을 요청합니다. setup guide에서는 이 두 가지 과정을 모두 안내합니다.
클라이언트 지원
Antigravity CLI, Claude Code, Codex, Grok 및 Kimi Code에 대한 통합이 제공됩니다. 다른 클라이언트는 자체 구성 및 조정 지침을 가지고 MCP를 통해 연결할 수 있습니다.
자동 전달은 클라이언트 버전 및 플랫폼에 따라 달라집니다. 검증된 통합(Verified integrations)을 사용하면 다음 일반 턴(normal turn)에서 메시지를 받을 수 있으며, 다른 세션에서는 ACC 받은 편지함(inbox)을 명시적으로 읽어야 합니다.
실험적인 라이브 전달(Experimental live delivery)은 적격한 Claude Code, Codex 및 Antigravity CLI 세션, Antigravity 데스크톱 앱의 대화, 그리고 Claude.app의 로컬 코드 세션을 깨울 수 있습니다. 이는 옵트인(opt-in)과 활성 검증 연결을 필요로 하며, 기본적으로 비활성화되어 있고 모델 토큰을 소모할 수 있습니다. Claude Code 세션은 Claude Code 자체가 여는 받은 편지함을 통해 깨어나므로, 평소처럼 명령어로 Claude Code를 시작합니다. 바쁜 Claude Code 세션은 두 도구 호출(tool call) 사이에 메시지를 받습니다. 바쁜 Codex 세션은 현재 턴이 끝날 때 메시지를 받습니다. Codex 앱의 채팅은 앱 자체 서버에서 실행되며 다음 턴에 메시지를 받습니다.
정확한 지원 내용은 클라이언트 기능(client capabilities)을 참조하십시오. 피어(peer)가 누락되었거나 전달이 예상과 다른 경우 프로젝트에서 acc doctor를 실행하십시오. 자세한 내용은 문제 해결(troubleshooting)을 참조하십시오. 에이전트가 언제 협력할지 결정하며, ACC는 모든 의존성을 감지한다고 보장하지 않습니다.
로컬 및 독립적 (Local and independent)
세션들은 동일한 ACC 작업 공간 내에서 조정을 공유합니다. Git은 선택 사항이며, 하나의 리포지토리(repository)의 워크트리(worktrees)는 별도의 파일을 유지하면서 해당 작업 공간을 공유합니다. 메시지와 인계(handoffs)는 프로젝트 외부의 로컬 앱 데이터에 저장됩니다. ACC는 원시 세션 기록(raw session transcripts)을 수집하거나 공유하지 않습니다.
ACC는 별도의 계정, 모델 API 키 또는 호스팅 서비스가 필요하지 않습니다. 코딩 클라이언트는 기존 제공업체 접근 방식을 계속 사용합니다.
자동 업데이트는 첫 설치 시 활성화됩니다. 비활성화하려면 acc update --auto off를 사용하고, 수동으로 업데이트하려면 acc update를 사용하며, 통합을 제거하려면 acc uninstall를 사용하십시오. 자세한 내용은 업데이트 제어(update controls)를 참조하십시오.
MIT 라이선스이며 영구적으로 비상업적입니다. 실제 작업 하나에 적용해보고 issue 열기를 통해 다음 내용을 알려주세요: 작동했는지, 어디서 문제가 발생했는지, 또는 여전히 세션 간 메시지를 직접 전달해야 했는지 여부입니다. 만약 작동했다면, 저장소의 릴리스를 확인하여 다음 버전에 대한 소식을 들어보세요. Discussions에 더 긴 글이나 설정 방법을 공유해 주시면 환영합니다.
문서화 (Documentation) · 기여하기 (Contributing)