노트북을 공유하지 않고 Claude Code나 Codex를 공유하는 방법

내 머신에서 실행되는 코딩 에이전트는 아마도 가장 유능한 동료일 것입니다. 하지만 에이전트에 무언가를 요청할 수 있는 사람은 오직 나뿐입니다. 런타임, 구독, 저장소, 인증 정보가 모두 한 대의 컴퓨터에만 존재하기 때문입니다. 이를 사용할 권한도 마찬가지입니다.

이 가이드에서는 사람들이 이 문제를 우회하기 위해 사용하는 방법들과 각 방식에서 감수해야 하는 위험, 그리고 다른 사람이 내 노트북에 전혀 손대지 않고도 에이전트에 작업을 보낼 수 있는 룸을 구성하는 방법을 다룹니다.

임시방편과 그 대가

이러한 방식은 모두 접근성을 얻는 대신 안전성을 포기합니다. 반면 룸 방식은 둘 다 포기하지 않습니다. 상대방은 요청할 수 있는 권한을 얻고, 소유자는 결정할 권한을 유지하며, 머신은 온전히 내 것으로 남습니다.

Remote Control과의 차이점

원격 접근이 필요한 사람이 나 자신이라면 Anthropic의 Claude Code Remote Control이 기본 해법입니다. 내 휴대전화가 내 세션을 들여다보는 창이 되기 때문입니다. 반면 룸은 다른 누군가가 에이전트를 사용해야 하고, 그들이 무엇을 실행할 수 있을지 내가 직접 결정하고 싶을 때 적합합니다. 두 기능은 함께 조합할 수 있습니다. 자세한 내용은 Remote Control vs 에이전트 룸을 참고하세요.

5단계로 룸 설정하기

머신 연결, 머신 승인, 에이전트 생성, 초대, 첫 요청 승인. 이후에도 네 가지 위험한 동작은 계속 일시 정지됩니다.

1. 머신 연결하기. 에이전트가 위치한 컴퓨터의 콘솔에서 connect 명령을 실행합니다. daemon이 로컬에 설치된 런타임(현재는 Claude Code 및 Codex)을 감지하고, 컴퓨터를 구분할 수 있도록 머신의 로컬 및 공인 주소를 보고합니다.

2. 머신 승인하기. 웹 앱에서 해당 컴퓨터가 본인 소유임을 확인할 때까지는 아무것도 실행되지 않습니다. 확인 후에는 daemon이 분리되어 백그라운드에서 계속 실행됩니다. muti service install로 서비스 등록을 해 두면 로그인 시 자동 실행되며 비정상 종료 시 재시작됩니다.

3. 에이전트 생성하기. 에이전트는 하나의 작업 디렉터리에 고정된 하나의 런타임이며, 고유한 이름과 권한 모드를 가집니다. 작업별로 하나씩 만드세요. 백엔드 저장소용 api, 마케팅 사이트용 site, 내보내기 파일이 있는 폴더용 ops와 같이 지정합니다. 디렉터리 범위를 좁혀 두면 승인 요청을 줄이고 실수의 여파를 최소화할 수 있습니다.

4. 사용자 초대하기. 룸을 생성하고, 에이전트를 추가한 뒤, 초대 링크를 보냅니다. 상대방은 로그인 후 룸에 접속하여 온라인 상태인 에이전트를 확인합니다. 상대방은 아무것도 설치할 필요가 없습니다.

5. 첫 번째 요청 승인하기. 상대방이 에이전트를 멘션하면 요청이 표시됩니다. 한 번만 승인하거나, 해당 에이전트에 대해 그 사람을 “always allow”로 지정할 수 있습니다. 어떤 방식이든 네 가지 위험한 작업 유형은 여전히 소유자의 승인을 기다리며 멈춥니다.

상대방에게 보이는 화면

룸에서 일어나는 모든 것만 보이며, 그 외에는 아무것도 보이지 않습니다.

• 작성되는 즉시 스트리밍되는 에이전트의 답변.
• 실시간으로 실행되는 각 도구 호출: 어떤 명령이 실행되었는지, 어떤 파일이 몇 줄 변경되었는지.
• 터미널을 열지 않고도 실패한 테스트를 확인할 수 있는 명령 출력의 마지막 부분(tail).
• 에이전트가 생성하여 룸의 출력물에 게시된 모든 파일이나 이미지.

상대방은 내 파일, 환경 변수, 키 또는 다른 룸을 절대로 볼 수 없습니다. daemon은 타임라인 이벤트를 업로드할 뿐, 작업 트리를 업로드하지 않습니다.

위험한 호출이 발생할 때 일어나는 일

공동 창업자가 에이전트에게 "간헐적으로 실패하는 테스트를 수정하고 푸시해 줘"라고 요청했다고 가정해 보겠습니다. 에이전트는 테스트를 편집하고 실행한 뒤 main 브랜치로 git push를 시도합니다. 이 호출은 즉시 중단됩니다.

소유자에게 카드 형태의 알림이 전송됩니다. 누가 요청했는지, 대상 에이전트는 무엇인지, 무엇을 하려고 하는지, 어떤 규칙에 걸렸는지가 표시됩니다. 승인하거나 거부할 수 있으며, 에이전트가 읽기 전용으로 계속 진행하도록 지시할 수도 있습니다. 메모를 추가할 수도 있는데, 이 메모는 원래 요청과 동일한 효력을 지닙니다. 콘솔이나 휴대전화에서, 또는 나중에 채팅 플랫폼에서 승인할 수 있으며 한 곳에서 내린 결정은 모든 곳에 적용됩니다. 응답하지 않은 승인 요청은 만료됩니다.

권한 회수하기

다음 네 가지 방법 중 하나를 통해 공유를 즉시 취소할 수 있습니다.

• 룸에서 멤버를 제거합니다.
• 에이전트에 대한 해당 사용자의 “always allow”를 Revoke합니다.
• 머신을 Revoke합니다.
• 머신에서 muti stop을 실행합니다.

해당 사용자를 위해 대기 중이던 모든 항목은 취소됩니다. 이미 실행 중인 작업은 끝까지 완료된 후 히스토리에 남아 감사 추적(audit trail)이 완전하게 유지됩니다.

실무 팁

• 읽기 전용으로 시작하세요. 상대방이 코드베이스를 변경하도록 허용하기 전에 먼저 탐색하고 질문할 수 있게 하세요.
• 작업 디렉터리당 하나의 에이전트. 문서 저장소만 필요한 사람이 프로덕션 설정을 볼 수 있는 에이전트를 멘션해서는 안 됩니다.
• 모델 이름이 아닌 업무 이름으로 에이전트 이름 짓기. deploy-checks는 팀원에게 무엇을 요청해야 할지 알려주지만, claude-2는 그렇지 못합니다.
• 머신이 절전 모드로 들어가지 않게 유지하세요. 머신이 잠들어 있는 동안에도 요청은 받은 편지함에 대기하지만, 주말 내내 닫혀 있는 노트북 덮개는 동료의 작업을 늦출 뿐입니다.

자주 묻는 질문

상대방도 Claude Code나 Codex를 설치해야 하나요? 아닙니다. 브라우저와 초대 링크만 있으면 됩니다. 에이전트는 내 구독을 사용하여 내 머신에서 실행됩니다.

상대방이 내 다른 룸이나 프로젝트를 볼 수 있나요? 아닙니다. 룸끼리는 아무것도 공유되지 않습니다. 상대방에게는 초대받은 룸만 표시됩니다.

에이전트가 이전 대화를 기억하나요? 기본적으로 각 룸은 자체적인 영구 세션을 유지하므로 에이전트는 해당 룸의 컨텍스트를 기억합니다. 필요에 따라 요청마다 새로운 세션을 시작하도록 룸을 전환할 수도 있습니다.

머신이 오프라인 상태이면 어떻게 되나요? 메시지는 에이전트의 받은 편지함에 대기열로 쌓이며 daemon이 다시 온라인이 되면 순서대로 실행됩니다. 실행되기 전에 받은 편지함의 항목을 삭제하거나 순서를 변경할 수 있습니다.

요약하자면, 에이전트에 룸을 만들어주고, 한 사람을 초대하고, 승인 권한을 유지하며, 노트북을 빌려주는 일은 그만두세요.