이런 분을 위한 글입니다
- Claude Code와 Codex를 함께 쓰는 개발자입니다.
- 휴대폰으로 내 컴퓨터에 작업을 맡기고 싶은 분입니다.
읽고 나면 이렇게 달라집니다
- Reason Network를 연결하고 에이전트끼리 검토를 요청합니다.
- 원격 작업의 실행 조건과 권한·비용을 구분합니다.
Claude Code가 고친 코드를 Codex에게 검토받고 싶을 때마다 설명과 코드를 복사하고 있나요? Reason Network를 사용하면 연결된 에이전트가 상대 세션을 찾아 메시지를 보내고 답을 받을 수 있습니다. Grok Bot 같은 온라인 비서를 통해 내 컴퓨터의 코딩 에이전트에 요청을 전달하는 것도 가능합니다.
다만 연결만 하면 꺼진 컴퓨터가 켜지거나, 모든 AI가 같은 대화와 파일을 공유하는 것은 아닙니다. 이 글에서는 연결 → 첫 메시지 → 코드 검토 → 휴대폰 요청 순서로 실제 작업에 필요한 조건까지 살펴봅니다.
2026년 11월 5일 확인한 Reason 공식 문서·연결 안내·공식 GitHub 저장소와 Grok Bot 공식 문서를 기준으로 작성했습니다. 공개 엔진의 최신 정식 릴리스는 v0.12.17(2026년 10월 30일)입니다. Reason CLI는 별도 제품이며 npm의 최신 버전은 0.2.678로 확인했습니다. 개발 브랜치의 변경을 배포 완료 기능으로 단정하지 않았습니다. 명령과 기능은 문서 확인 기준이며, 이 글에서 실제 계정 연결이나 기기 간 실행을 수행한 것은 아닙니다. 예제의 계정명·세션명·경로는 자신의 환경으로 바꾸세요.
Reason Network란?
Reason Network는 내 컴퓨터와 팀원 컴퓨터에서 실행 중인 AI 에이전트를 연결해, 세션을 찾고 질문과 작업 요청을 주고받게 하는 도구입니다. Reason Machines가 제공하며 네트워크 연결은 무료입니다. Claude Code와 Codex를 만든 회사의 기본 내장 연동 기능이 아니라, 별도로 설치하는 연결 도구입니다.
Claude Code, Codex, Cursor 같은 코딩 에이전트를 연결할 수 있습니다. Grok Bot·Muse·ChatGPT 같은 온라인 비서는 원격 MCP 서버로 접속합니다. MCP는 AI가 외부 도구를 호출할 수 있도록 연결하는 규약입니다.
역할을 나누면 이해하기 쉽습니다.
| 구성 요소 | 맡는 일 |
|---|---|
| Claude Code·Codex 등 | 저장소를 읽고 코드를 수정하거나 검토 |
| Reason Network | 세션 발견, 메시지 전달, 응답 전달 |
| Grok Bot 등 온라인 비서 | 휴대폰·웹에서 요청을 받아 연결된 세션에 전달 |
| Reason의 클라우드 세션 | Reason 측 컴퓨터에서 별도로 작업 실행 |
무료인 Reason Network와 유료 작업이 발생할 수 있는 Reason 클라우드 세션은 구분해야 합니다. 연결된 Claude Code·Codex·Grok Bot의 기존 구독과 사용량 제한도 그대로 적용됩니다.
Reason Network가 필요한 이유: AI 사이의 전달 작업 줄이기
여러 AI를 쓰면 구현과 검토를 나눌 수 있습니다. 하지만 사람이 중간에서 정보를 옮기면 대상 저장소, 변경 이유, 테스트 결과를 빠뜨리기 쉽습니다. Reason Network는 상대의 저장소·브랜치·작업 상태를 확인한 뒤 특정 세션에 질문하는 흐름을 제공합니다.
예를 들어 Claude Code에게 구현을 맡기고 Codex에는 읽기 전용 검토를 요청할 수 있습니다. 프런트엔드 에이전트가 백엔드 담당 세션에 API 응답 형식을 확인하거나, 외출 중 Grok Bot에서 집 컴퓨터의 실패한 테스트 분석을 요청할 수도 있습니다.
다만 네트워크는 공유 파일 시스템이나 Git 동기화 도구가 아닙니다. 다른 컴퓨터의 Codex가 같은 경로를 갖고 있다고 가정하면 안 됩니다. 검토 요청에는 저장소, 브랜치나 커밋, 변경 파일, 기대 동작을 함께 전달하세요. 다른 기기에 수정본이 없다면 검토할 diff나 커밋을 먼저 전달해야 합니다.
이런 작업부터 연결해 보세요
- 구현 담당과 검토 담당을 나누는 작업
- 다른 저장소의 계약이나 설정을 물어보는 작업
- 팀원이 작업 중인지 확인한 뒤 겹치는 수정을 조율하는 작업
읽기 전용 검토를 요청하는 프롬프트는 작업 범위를 설명하는 지시입니다. 파일 쓰기를 기술적으로 차단하는 권한 설정과는 다릅니다. 확실하게 제한해야 한다면 사용하는 에이전트의 권한 설정도 함께 적용하세요.
간단한 질문 한 번이면 수동 복사가 더 빠를 수도 있습니다. 같은 방식의 전달을 반복하고 있거나 여러 기기·팀원 사이의 협업이 필요할 때 연결의 가치가 커집니다.
최신 버전과 기존 안내에서 달라진 점
2026년 11월 5일 기준으로 공식 문서와 공개 릴리스에 다음 차이가 있습니다.
| 항목 | 현재 확인한 내용 |
|---|---|
| 도구 수 | 시작 문서는 4개를 소개하지만 v0.12.17 README에는 message_status도 안내 |
| 기존 Claude Code 세션 | 설치 안내는 재시작을 권장하지만 릴리스 README는 재시작 없는 합류도 설명 |
| 메시지 상태 | 최신 릴리스는 전달 전 거절과 전달 여부가 불확실한 상태를 구분하는 수정 포함 |
| 개인정보 설명 | 릴리스 README에 사용량 집계·보고 범위와 보고 제한 방법 안내 |
| Windows 개발 변경 | 11월 5일 main에 Reason CLI 탐색 관련 수정이 있으나 정식 릴리스 배포 여부와 구분 필요 |
2ms 전달·2초 응답 같은 수치는 모든 환경의 보장값이 아닙니다. 모델의 응답 시간, 작업량, 네트워크 상태에 따라 달라지므로 설치 성공 기준으로 사용하지 않습니다.
설치 전 준비물과 지원 범위
| 준비물 | 확인할 내용 |
|---|---|
| 로컬 코딩 에이전트 | Claude Code나 Codex 등 사용할 에이전트가 설치되고 로그인되어 있는지 |
| 컴퓨터 | 이 글은 macOS·Linux의 Reason CLI 경로와 Windows의 공식 Network 전용 설치 경로를 설명 |
| Reason 로그인 | macOS·Linux 안내 기준 Google·GitHub·Apple·이메일 |
| 온라인 비서, 선택 사항 | 원격 MCP 서버 추가와 인증을 지원하는지 |
| 작업 저장소 | 에이전트가 읽거나 수정할 프로젝트가 있는지 |
공식 시작 문서는 Claude Code·Codex·Cursor·Gemini CLI·Copilot CLI·opencode·Pi의 자동 설정을 안내합니다. 공식 저장소에는 더 많은 통합이 기재되어 있습니다. 지원 목록에 있다는 것과 메시지가 같은 시점에 도착한다는 것은 다릅니다. 에이전트에 따라 실행 중 전달, 도구 호출 뒤 전달, 받은편지함 확인 방식이 달라질 수 있습니다.
설치 명령은 인터넷의 스크립트를 받아 실행합니다. 주소가 정확한지 확인하고 회사 컴퓨터라면 조직의 설치·AI 사용 규칙을 확인하세요. 먼저 개인용 테스트 저장소에서 시작하면 연결 범위를 이해하기 쉽습니다.
1. Claude Code·Codex에 Reason Network 연결하기
가장 쉬운 방법: 에이전트 대화창에 붙여넣기
내 컴퓨터에서 사용하는 코딩 에이전트에 다음 문장을 보냅니다.
Join the Reason Network: https://reasonmachines.com/network브라우저가 열리면 로그인하고 네트워크를 만들거나 초대받은 네트워크에 참여합니다. 설치 과정은 해당 컴퓨터의 지원 에이전트에 MCP 도구·훅·스킬을 설정합니다. 훅은 에이전트 실행 중 정해진 시점에 연결 기능을 호출하는 장치입니다.
이미 열려 있던 세션에서 도구가 보이지 않으면 세션을 다시 여세요. 시작 문서는 재시작을 안내하고, 최신 저장소는 기존 Claude Code 세션의 재시작 없는 연결도 설명합니다. 처음 따라 한다면 설치 후 새 세션을 열어 확인하는 방식이 명확합니다.
터미널에서 직접 설치하기
macOS·Linux에서는 다음 명령을 실행합니다.
curl -fsSL https://reasonmachines.com/install.sh | bash -s -- networkWindows에서는 PowerShell을 사용합니다.
irm https://reasonmachines.com/network/install.ps1 | iex이 Windows 설치 경로는 Network 문서 기준 로그인 없이 오픈소스 엔진으로 네트워크를 시작하거나 참여하며, 이름이 미인증으로 표시됩니다. 이것은 Reason CLI 자체가 Windows를 지원하지 않는다는 뜻이 아닙니다. 최신 Reason CLI README는 Windows x64·ARM64 지원도 안내합니다. 이 글에서는 인증 흐름을 혼동하지 않도록 Network 전용 설치 경로를 따릅니다.
연결 성공을 확인하는 프롬프트
Reason Network의 list_team으로 현재 연결된 세션을 확인해 줘.
각 세션의 정확한 주소, 컴퓨터, 저장소, 브랜치, busy/idle 상태를 정리해 줘.
아직 다른 에이전트에게 메시지를 보내거나 파일을 수정하지 마.macOS·Linux의 Reason CLI에서는 다음 명령으로도 확인할 수 있습니다.
reason network who
reason network team오픈소스 엔진의 실행 파일 이름은 운영체제와 관계없이 reason-network입니다. 위 Windows 전용 설치를 사용했다면 이 명령을 사용합니다. 예를 들어 reason-network who를 사용합니다. 이 글의 이후 reason network ... 예제는 Reason CLI 기준입니다.
2. Claude Code가 Codex에게 직접 검토 요청하기
연결 직후에는 수정 요청보다 읽기 전용 검토로 왕복 전달을 확인하는 것을 권합니다. 같은 프로젝트의 작은 변경 하나를 준비하고 Claude Code에 다음 프롬프트를 보내세요.
현재 변경 사항을 Reason Network의 Codex 세션에게 검토받고 싶어.
1. list_team으로 후보를 찾고 저장소와 브랜치를 확인해.
2. 후보가 여러 개이거나 저장소가 다르면 대상부터 내게 물어봐.
3. 검토 대상 브랜치·커밋, 변경 파일, 목적, diff, 테스트 결과를 정리해 보내.
4. 상대가 수정본에 접근 가능한지 확인하고, 없으면 검토에 필요한 diff를 전달해.
5. Codex에는 파일 수정 없이 버그·회귀 가능성·누락된 테스트만 검토해 달라고 해.
6. 답을 받으면 문제별 파일 위치, 이유, 수정 제안을 내게 요약해.
검토 요청이 전달됐다는 사실과 실제 검토가 끝났다는 사실을 구분해서 알려줘.명령으로 특정 세션에 질문할 수도 있습니다. 아래 alice/codex는 예시이므로 who에 나온 실제 주소로 바꾸세요.
reason network alice/codex "현재 저장소와 브랜치를 알려줘. 파일은 수정하지 마."응답을 기다리지 않고 메시지만 보낼 때는 다음 형식을 사용합니다.
reason network send alice/codex "검토할 diff를 곧 보낼게. 지금은 파일을 수정하지 마."에이전트가 사용하는 주요 도구
| 도구 | 역할 |
|---|---|
list_team | 세션·기기·저장소·브랜치·작업 상태 확인 |
send_message | 선택한 세션으로 메시지 전송 |
check_inbox | 직접 전달이 어려운 환경에서 받은 메시지 확인 |
ask_user | 로컬 에이전트가 사용자에게 팝업으로 질문 |
message_status | v0.12.17 릴리스 README에 안내된 전송 진행 상태 확인 |
이 표는 로컬 코딩 에이전트의 주요 도구입니다. 온라인 비서는 원격 MCP가 제공하는 도구 구성이 다를 수 있고, Reason 세션은 이 도구를 직접 받는 대신 로컬 shell의 Network 명령을 사용하는 예외가 있습니다. 시작 문서는 네 가지 핵심 도구를 소개하지만 v0.12.17 릴리스 README는 message_status도 설명합니다. 설치 환경에서 실제 제공되는 도구 목록을 확인하세요. 전송됨·상대 시스템이 받음·에이전트에게 전달됨·답변 완료는 서로 다른 상태입니다.
3. 휴대폰의 Grok Bot으로 집 컴퓨터에 작업 맡기기
휴대폰 원격 작업의 핵심 조건은 온라인 비서의 MCP 연결, 온라인 상태의 내 컴퓨터, 요청을 받을 로컬 에이전트입니다. 일반 Grok 대화에 문장을 보내는 것만으로 설정이 완료되는 것은 아닙니다.
Grok Bot에 원격 MCP 서버 추가하기
Reason의 Grok Bot 연결 안내는 Bot settings → MCP Servers → Add a custom MCP 경로를 안내합니다. 여기에 다음 주소를 추가하고 Reason 인증 화면에서 같은 계정과 네트워크를 선택합니다.
https://mcp.reasonmachines.com/mcp주소 입력만으로 연결이 끝나지 않습니다. 인증을 완료한 뒤 Grok Bot에 “list_team으로 연결된 세션을 보여 줘”라고 요청해 확인하세요. UI 이름은 업데이트에 따라 달라질 수 있습니다. Grok Bot 공식 문서에서도 URL을 통한 사용자 지정 MCP 서버 추가를 지원합니다.
Muse·ChatGPT 등도 Reason 측 안내상 같은 원격 MCP 서버를 사용합니다. 실제 추가 메뉴와 사용 가능 여부는 각 서비스의 계정·관리자 설정에 따라 확인해야 합니다. 온라인 비서가 가진 별도 클라우드 컴퓨터에 설치 스크립트를 실행하는 방식으로 연결하지 않습니다.
집 컴퓨터에서 수신할 에이전트 준비하기
열려 있는 Claude Code 세션으로 요청을 보내거나, 공식 문서가 안내하는 작업용 worker를 실행할 수 있습니다. worker는 창에서 계속 대화하지 않아도 네트워크 요청을 처리하도록 실행한 에이전트입니다.
# 자신의 프로젝트 경로로 변경
cd ~/code/my-project
# 이 폴더에서 요청을 처리할 Claude Code 실행
reason network serve claudeCodex worker를 사용할 경우에는 다음 명령을 사용합니다.
reason network serve codex위 serve 예제는 Reason CLI의 Network worker 기능입니다. Windows의 reason-network 엔진에 같은 serve 하위 명령이 있다고 가정하지 마세요. worker 실행은 이미 설치·인증된 에이전트와 프로젝트 접근 권한을 전제로 합니다. 이 명령을 실행한 프로세스를 유지해야 요청을 처리할 수 있으며, 설치만으로 worker가 상시 실행되는 것은 아닙니다. 컴퓨터가 켜져 있어도 절전 상태로 네트워크와 프로세스가 멈추면 즉시 처리할 수 없습니다. 외출 전에 아래 항목을 확인하고 휴대폰에서 읽기 전용 질문을 보내 왕복 응답을 확인하세요.
- 내 컴퓨터가 켜져 있고 네트워크가 유지되는지 확인합니다.
- Grok Bot이 같은 네트워크로 인증되어 있는지 확인합니다.
- list_team에서 요청할 세션이 보이는지 확인합니다.
- 대상 저장소와 브랜치, 수정·명령 실행 권한을 확인합니다.
기본 worker에서 Claude·Grok은 파일을 읽고 수정할 수 있지만 명령 실행은 제한됩니다. Codex는 공식 문서상 자체 sandbox와 --full-auto로 실행됩니다. 따라서 “버그를 수정한다”와 “테스트 명령까지 실행한다”는 조건이 다릅니다. --full-access는 확인 없이 모든 명령 실행을 허용하는 옵션이므로, 테스트를 위해 무조건 켜는 방식으로 사용하지 마세요.
휴대폰에서 복사해서 쓸 요청
Reason Network에서 내 my-project 저장소의 Claude Code 세션을 찾아 줘.
대상이 여러 개라면 주소와 브랜치를 보여주고 내 선택을 기다려.
선택된 세션에는 다음을 요청해:
- 최근 실패한 checkout 테스트의 원인을 조사해.
- 우선 파일을 수정하지 말고 재현 조건과 수정 계획을 보고해.
- 테스트 명령 실행 권한이 없으면 실행했다고 말하지 말고,
필요한 명령과 막힌 이유를 알려줘.
- 내 승인 후 관련 파일만 수정하고 변경 요약과 검증 결과를 보내.
- 커밋·push·PR 생성·배포는 하지 마.ask_user는 로컬 화면에 질문을 띄우는 기능입니다. 그 팝업이 휴대폰 승인창으로 자동 전달된다고 가정하면 안 됩니다. 자리를 비울 때는 승인 요청을 어디서 확인할지도 미리 정하세요.
Grok Bot이 나중에 온 답변을 스스로 처리하게 하려면 받은편지함을 확인하는 routine이나 webhook 기반 깨우기 설정이 별도로 필요할 수 있습니다. 첫 실습에서는 “받은 답변을 확인해 줘”라고 직접 요청해 응답부터 확인하세요. 메시지 전달과 지속적인 백그라운드 처리 설정을 나눠 점검하면 원인을 찾기 쉽습니다.
4. 다른 컴퓨터와 팀원 연결하기
macOS·Linux의 인증 설치 경로에서는 내 다른 컴퓨터에서도 같은 설치 과정을 진행하고 같은 Reason 계정으로 로그인합니다. 위 Windows 전용 설치는 로그인 없는 별도 흐름이므로 이 설명과 구분하세요. 팀원은 각자의 계정으로 초대받은 네트워크에 참여합니다.
reason network invite출력된 초대 문장을 팀원에게 전달하세요. 아래는 형식 예시이며 실제 초대 링크가 아닙니다.
Join the Reason Network: https://reasonmachines.com/network/join/#rn1-…초대 링크를 가진 사람은 참여할 수 있으므로 공개 저장소나 공개 채팅에 올리지 마세요. 컴퓨터 한 대는 한 번에 하나의 네트워크에 연결됩니다.
팀에서 사용할 때는 “누가 수정하고 누가 검토하는가”를 먼저 정하세요. 같은 저장소에서 에이전트 둘이 동시에 편집하면 파일 충돌이 생길 수 있습니다. 별도 브랜치·worktree로 수정 공간을 나누거나 한쪽을 읽기 전용으로 두는 방식이 좋습니다. busy 상태 표시는 참고 정보이며 파일 잠금 장치가 아닙니다.
Reason Network에서 이 저장소를 작업 중인 세션을 확인해 줘.
각 담당자에게 수정 중인 파일과 작업 범위를 물어보고 요약해.
겹치는 파일이 있으면 내가 담당을 정할 때까지 수정하지 마.
다른 세션의 변경 사항을 되돌리거나 덮어쓰지 마.5. 연결이 안 될 때 확인할 순서
| 증상 | 먼저 확인할 것 | 다음 행동 |
|---|---|---|
| 세션이 목록에 없음 | 설치 후 세션을 다시 열었는지 | 새 세션에서 한 번 대화하고 목록 확인 |
| 다른 기기가 안 보임 | 같은 네트워크에 참여했는지 | 계정과 네트워크 확인 |
| 휴대폰 요청이 시작되지 않음 | 로컬 기기와 수신 세션이 온라인인지 | 직접 읽기 전용 메시지를 보내 응답 확인 |
| 보냈는데 답이 없음 | 전송과 실행 완료를 혼동했는지 | 제공되는 경우 message_status, 상대 inbox 확인 |
| 수정은 했는데 테스트를 못 함 | worker의 명령 실행 권한 | 미실행 이유와 필요한 명령 확인 |
| 연결 상태가 이상함 | 설정·통신 문제 | doctor로 점검 |
Reason CLI의 진단 명령은 다음과 같습니다.
reason network who
reason network team
reason network doctor특정 폴더의 세션을 네트워크에서 제외하거나 다시 포함할 수도 있습니다.
reason network folder ~/code/private-project off
reason network folder ~/code/private-project on위 명령은 세션 노출 범위를 조정하는 기능입니다. 이미 전달한 메시지나 상대가 받은 정보까지 회수하는 기능으로 생각하면 안 됩니다.
비용과 보안: 무료·암호화의 정확한 범위
Reason Network 연결은 무료지만, 연결된 AI가 수행하는 작업의 사용료까지 무료가 되는 것은 아닙니다. Claude Code·Codex·Grok Bot은 각 서비스의 구독·API 요금·사용량 제한을 따릅니다. Reason 클라우드 세션의 실행 비용도 별도입니다.
보안 역시 구간을 나눠 이해해야 합니다.
- 컴퓨터끼리의 메시지는 공식 설명상 종단간 암호화됩니다. 직접 연결이 어려울 때 사용하는 중계 서버는 암호화된 데이터를 전달합니다.
- 온라인 비서는 Reason 서버를 거쳐 연결합니다. 컴퓨터 간 암호화 설명을 모든 온라인 비서 구간의 비공개 보장으로 확대하지 마세요.
- 팀원은 세션의 기기·저장소·브랜치·작업 상태를 볼 수 있습니다. 연결할 프로젝트 범위를 확인하세요.
- 다른 사람 에이전트의 메시지는 동료 요청으로 취급하도록 설계되어 있습니다. 그래도 민감한 작업은 구체적인 권한·검토 절차로 제한해야 합니다.
메시지 암호화와 사용량 보고는 별개입니다
v0.12.17 README에는 엔진이 사용량 집계를 로컬에 보관하고, Reason CLI와 함께 사용할 때 최근 집계를 약 5분 간격으로 보고한다고 설명합니다. 보고 항목에는 에이전트 종류, 전달 단계, 전송 경로, 크기·지연 구간 같은 메타데이터가 포함됩니다. 메시지 본문·파일·파일명·저장소·세션명·키 등은 이 보고에 포함되지 않는다고 명시합니다.
보고는 Reason 계정과 엔진에 연결되므로 익명 데이터라고 설명할 수 없습니다. standalone 엔진은 이 집계를 직접 업로드하지 않으며, Reason 명령 실행 시 DO_NOT_TRACK=1을 설정하면 집계를 로컬에 유지하도록 안내합니다. 따라서 “서버로 어떤 데이터도 보내지 않는다”는 설명은 정확하지 않습니다.
공개된 것은 MIT OR Apache-2.0 라이선스의 네트워크 엔진입니다. 설치를 돕는 Reason CLI와 Reason 전체 서비스까지 모두 같은 오픈소스 범위라고 이해하면 안 됩니다.
자주 묻는 질문
마무리: 첫 작업은 작은 읽기 전용 요청으로 시작하세요
Reason Network의 핵심은 여러 AI의 답을 사람이 옮기는 대신, 작업 중인 세션을 찾아 직접 질문하게 만드는 것입니다. 먼저 Claude Code와 Codex를 연결해 저장소·브랜치를 확인하고, 작은 diff 하나를 검토받아 보세요. 그다음 worker와 온라인 비서를 연결하면 휴대폰 요청도 실행 조건을 이해한 상태로 확장할 수 있습니다.
여러 에이전트의 작업을 나누는 방법이 궁금하다면 Agentlas 설치·사용법을 이어서 읽어 보세요. MCP 연결과 복사용 프롬프트를 더 익히고 싶다면 prompts.chat 사용법도 도움이 됩니다.