Claude Code 및 Codex CLI 세션을 실시간으로 공유하는 방법: 읽기 전용 라이브 링크 생성

가능하며, 화면을 공유하거나 에이전트 제어권을 상대방에게 넘길 필요도 없습니다. PandaNpc의 Claude Code 또는 Codex CLI 세션에서 공개 읽기 전용 링크를 생성한 다음 '실시간 새로고침'을 켜면, 방문자는 브라우저에서 기존 대화, 이후 메시지, 도구 출력을 볼 수 있습니다. 라이브 시간은 1, 6 또는 24시간 중에서 선택할 수 있습니다. 라이브를 중지한 후에도 링크는 마지막 스냅샷을 계속 표시하며, 완전히 무효화해야 할 때 공유를 철회하면 됩니다.

이는 페어 디버깅, 원격 데모, 고객 승인 및 비동기 리뷰에 적합합니다. Claude Code와 Codex CLI는 여전히 당신의 개발 머신에서 실행되며, 방문자는 단지 관람자일 뿐입니다. 두 CLI의 설치 및 실행 방법은 각각 Anthropic의 Claude Code 시작 문서와 OpenAI의 Codex CLI 문서를 참조할 수 있습니다.

먼저 구분하자: 스냅샷, 실시간 공유, 연결 공유는 서로 다른 것이다

이 글에서는 앞의 두 가지를 다룹니다. 먼저 공개 읽기 전용 스냅샷을 생성한 다음, 필요에 따라 실시간 새로고침을 켭니다. 최종 산출물만 보여주고 싶다면 세션 결과 페이지를 사용할 수 있고, 상대방이 실제로 지시를 보내야 한다면 Claude Code 연결 공유의 권한 경계를 먼저 읽어보세요.

시작 전에 필요한 것

• 개발 머신에서 Claude Code 또는 Codex CLI가 정상적으로 작동하고 있을 것;
• PandaPaw가 해당 개발 머신에 연결되어 있고, 대상 세션을 PandaNpc Agent에서 열 수 있을 것;
• 세션에 공유 가능한 메시지가 최소 하나 이상 있을 것;
• 기록 내용을 검토하여 비밀번호, API Key, 개인 키, 고객 데이터 또는 공개되어서는 안 되는 기타 정보가 없는지 확인했을 것.

공유 링크는 방문자 로그인이 필요 없습니다. 편리하다는 것은 곧 본질적으로 bearer link임을 의미합니다. 링크를 가진 사람은 누구나 볼 수 있습니다. 따라서 '링크를 맞히기 어렵다'는 것을 권한 제어로 삼지 마세요.

Claude Code 또는 Codex CLI 세션을 실시간으로 공유하는 방법

1단계: 공유할 세션 열기

PandaNpc Agent에 들어가서 Claude Code 또는 Codex를 실행하는 프로젝트를 선택한 다음, 실행 중이거나 완료된 세션을 엽니다. 먼저 제목과 대화 내용을 확인하여 올바른 프로젝트를 공유하는지 확인하세요.

2단계: 공개 읽기 전용 링크 생성

세션 오른쪽 상단의 공유 버튼을 클릭합니다. 처음 공유할 때:

1. 링크 유효 기간을 선택합니다: 7일, 30일 또는 영구;
2. 구조화된 요약이 필요하면 '결과 페이지 생성'을 유지하고, 원본 대화만 라이브로 보여주려면 끕니다;
3. 링크 생성 버튼을 클릭하고 복사합니다.

링크가 생성되는 순간 현재 전체 대화가 스냅샷으로 저장됩니다. 이후 라이브를 켜지 않아도 방문자는 이 링크를 통해 이 스냅샷을 읽을 수 있습니다.

3단계: '실시간 새로고침' 켜기

링크가 생성된 후 같은 공유 팝업에서 실시간 새로고침을 찾아 1시간, 6시간 또는 24시간을 선택한 다음 '라이브 시작'을 클릭합니다. 페이지에는 남은 시간이 표시되며, 작업이 예상보다 오래 걸리면 라이브 시간을 연장할 수 있습니다.

4단계: 시크릿 창으로 검증하기

'링크가 복사되었습니다'라는 안내만 믿지 마세요. 시크릿 창이나 로그인하지 않은 다른 기기에서 공유 링크를 연 다음, 원래 세션에서 민감한 정보가 포함되지 않은 테스트 메시지를 보내세요. 방문자 페이지에는 보통 약 3~10초 내에 새 내용이 나타나고 라이브 상태가 표시됩니다.

이 단계는 네 가지를 동시에 검증합니다. 공개 링크에 접근할 수 있는지, 방문자에게 로그인이 필요 없는지, 현재 라이브 시간이 유효한지, 새 메시지가 실제로 올바른 세션에서 오는지입니다.

방문자가 실시간으로 볼 수 있는 것

라이브를 켠 후 링크를 가진 사람은 다음을 볼 수 있습니다:

• 공유를 시작할 때 이미 존재했던 전체 대화;
• 라이브 기간 중 새로 추가된 사용자 메시지와 에이전트 응답;
• 이후의 도구 출력(읽은 파일 내용, Shell 명령 및 그 출력 포함);
• 세션이 아직 작동 중인지 여부와 모델, 컨텍스트, 파일 변경 사항 등의 읽기 전용 상태;
• 결과 페이지가 생성된 경우 구조화된 결과 요약으로 전환할 수도 있습니다.

방문자는 이 페이지를 통해 메시지를 보내거나, 에이전트의 질문에 답하거나, 명령을 승인하거나, 개발 머신을 제어할 수 없습니다. 휴대폰에서 자신의 Codex를 계속 조작하려면 Codex CLI 원격 제어 방법을 사용하세요. 시청용 링크를 원격 제어 진입점으로 착각하지 마세요.

개인정보 및 보안: 라이브 시작 전 반드시 확인할 사항

실시간 공유는 일반 스냅샷보다 더 주의가 필요합니다. 에이전트가 다음에 무엇을 읽을지 아직 모르기 때문입니다. 시작 전에 최소한 다음 항목을 확인하세요:

1. 기록 내용을 정리하세요. 이미 대화에 나타난 키와 파일 조각은 초기 스냅샷과 함께 공개됩니다.
2. 이후 도구 호출을 예상하세요. 에이전트가 .env, 설정 파일, 로그 또는 고객 데이터를 읽은 후 해당 도구 출력이 방문자 페이지에 그대로 나타날 수 있습니다.
3. 가장 짧은 충분한 시간을 선택하세요. 10여 분 분량의 데모는 보통 1시간을 선택하면 되며, 클릭 한 번 아끼려고 24시간을 바로 켤 필요는 없습니다.
4. 꼭 봐야 하는 사람에게만 보내세요. 공개 읽기 전용이公开发布에 적합하다는 뜻은 아닙니다. 단체 채팅으로 전달하면 전파 범위가 더 넓어질 수 있습니다.
5. 종료 후에는 중지하거나 철회하세요. 라이브를 중지하면 마지막 스냅샷으로 고정될 뿐입니다. 원래 링크를 완전히 접근 불가능하게 하려면 공유를 철회해야 합니다.

혼동하기 쉬운 또 하나의 점은, 세션 공유는 읽기 전용이고 연결 공유는 조작이 가능하다는 것입니다. 후자는 상대방이 당신의 호스트에서 지시를 보내고 도구 호출을 승인할 수 있게 허용할 수 있으므로, 신뢰할 수 있는 구성원에게만 사용해야 합니다.

라이브 종료 후 어떻게 되는가

라이브가 종료되는 방식은 세 가지입니다:

• 1, 6 또는 24시간의 제한 시간에 도달하면 자동으로 중지;
• 공유 팝업에서 '라이브 중지'를 수동으로 클릭;
• 공유 전체를 철회.

앞의 두 방식은 계속 업데이트만 중단할 뿐, 방문자는 중지 시점까지의 스냅샷을 계속 읽을 수 있습니다. 공유를 철회하면 원래 공개 링크가 무효화됩니다. 나중에 같은 세션을 다시 공유할 때는 이를 새로운 공개 진입점으로 간주하고 내용과 유효 기간을 다시 확인하세요.

일반적인 문제 해결

실시간 새로고침을 켰는데 방문자는 이전 스냅샷만 보입니다

먼저 공유 팝업에 여전히 '라이브 중'과 남은 시간(분)이 표시되는지 확인한 다음, 개발 머신, PandaPaw 및 대상 세션이 온라인인지 확인하세요. 실시간 데이터를 일시적으로 사용할 수 없으면 페이지는 안전하게 마지막 스냅샷으로 대체되며, 추가 권한이 열리지는 않습니다.

방문자에게 페이지를 다시 전면으로 전환하도록 요청할 수도 있습니다. 브라우저 탭이 오랫동안 백그라운드에 있으면 새로고침이 일시 중지되며, 탭을 다시 열면 새 메시지를 계속 가져옵니다.

새 메시지가 즉시 나타나지 않습니다

방문자 페이지는 문자 단위 동기화가 아닌 준실시간 새로고침을 사용합니다. 일반적으로 몇 초 내에 업데이트되며, 새 메시지가 계속 없으면 불필요한 요청을 줄이기 위해 새로고침 간격이 점차 약 10초까지 늘어납니다. 이러한 지연은 세션이 개발 머신에서 계속 실행되는 것에는 영향을 미치지 않습니다.

'라이브 시작' 후 스위치가 다시 꺼집니다

보통 서버가 현재 온라인 세션을 찾지 못했음을 의미합니다. 대상 세션 내에서 작업 중인지, 기기가 여전히 온라인인지 확인한 후 Agent 페이지를 새로고침하고 다시 시도하세요. 기존 스냅샷은 계속 읽을 수 있으므로 새 링크를 반복해서 생성할 필요가 없습니다.

링크가 존재하지 않거나 이미 무효라고 표시됩니다

링크가 전체가 복사되었는지, 7/30일 유효 기간이 지났는지, 또는 이미 철회되었는지 확인하세요. 만료되거나 철회된 링크는 방문자가 복구할 수 없으며, 공유자가 다시 생성해야만 합니다.

결과 페이지가 계속 생성 중입니다

결과 페이지는 추가 AI 요약이 필요하므로 읽기 전용 스냅샷보다 늦게 나타날 수 있습니다. 결과 페이지와 실시간 새로고침은 서로 독립적입니다. 결과 페이지가 아직 생성 중이어도 원본 세션 라이브는 정상적으로 시청할 수 있습니다.

FAQ

Claude Code와 Codex CLI 모두 같은 방법으로 공유할 수 있나요?

네. 해당 세션이 PandaNpc Agent에 나타나기만 하면 세션 오른쪽 상단에서 동일한 공유 진입점을 사용하면 됩니다. 핵심 작업이 모두 'AI 코딩 세션을 공개 읽기 전용 실시간 시청 링크로 만드는 것'이므로 문서는 하나면 충분합니다.

방문자에게 PandaNpc, Claude 또는 ChatGPT 계정이 필요한가요?

아니요. 공유 페이지는 공개 읽기 전용 페이지이므로 방문자는 브라우저로 열면 됩니다. 로그인이 필요 없다는 점 때문에 링크를 민감한 정보처럼 취급해야 합니다.

방문자가 Claude Code 또는 Codex를 제어할 수 있나요?

아니요. 세션 공유 페이지는 시청만 가능하며, 메시지 전송, 명령 승인 또는 호스트 조작은 할 수 없습니다. 두 사람이 함께 조작해야 한다면 권한이 더 높은 연결 공유를 사용하고, 신뢰할 수 있는 협업자만 초대하세요.

이것은 화면 공유와 어떤 차이가 있나요?

화면 공유는 전체 데스크톱 화면을 전송하며, 보통 회의나 스크린 미러링 연결을 유지해야 합니다. 세션 공유는 이 AI 코딩 세션의 구조화된 메시지와 도구 출력만 표시합니다. 방문자는 직접 스크롤하거나 다시 볼 수 있으며, 데스크톱의 다른 창은 볼 수 없습니다.

라이브를 중지하면 링크가 삭제되나요?

아니요. 중지 후에도 링크는 마지막 스냅샷을 유지합니다. '공유 철회'를 선택해야 링크가 무효화됩니다.

최종 결과만 공유하고 전체 대화는 공개하지 않아도 되나요?

네. 공유 시 결과 페이지를 생성하여 무엇을 했는지, 어떤 파일을 수정했는지, 남은 작업이 무엇인지 구조화된 요약으로 보여줄 수 있습니다. 주의할 점은, 같은 공유 링크가 여전히 전체 세션 진입점을 제공할 수 있다는 것입니다. 원본 대화를 공개하기에 적합하지 않다면 먼저 내용을 정리하거나 공개 공유를 만들지 마세요.

요약

Claude Code 또는 Codex CLI 세션을 실시간 공유할 때 가장 안전한 절차는 다음과 같습니다. 내용을 먼저 확인하고, 공개 읽기 전용 스냅샷을 생성하고, 가장 짧은 라이브 시간을 선택하고, 시크릿 창으로 검증하고, 종료 후 중지하거나 철회하세요. 이 방식은 AI 코딩 과정을 현장에서 지켜보는 가치를 유지하면서도 방문자 권한을 읽기 전용으로 제한합니다.

시작할 준비가 되면 PandaNpc Agent를 열고 대상 세션을 선택한 다음 오른쪽 상단의 공유 버튼을 클릭하면 됩니다.