모바일 · 연결이 끊긴 뒤 자동 복구되지 않는 보고
확인 화면: Open Claude Code #34255는 macOS·iOS, CLI 2.1.76에서 장시간 사용 중 연결이 조용히 끊어지고 수동 재연결이 필요하다는 보고입니다.
이는 폰과 로컬 세션 사이의 원격 연결 문제입니다. 폰의 응답이 멈춘 것만으로 로컬 작업도 멈췄다고 판단하지 말고 실행 상태와 결과 파일을 확인해야 합니다.
처음엔 왜 터미널이었나
혼자 쓰려던 실험이라 화면을 만들 필요가 없었고, 터미널에 있어야 bash·파일·git을 그대로 쓸 수 있었습니다. Anthropic은 “의도적으로 저수준이고 특정 방식을 강요하지 않는 도구”라고 설명했습니다.
지금은 어디서 같은 일을 하나
터미널, VS Code·JetBrains, 데스크톱 앱, 웹, iOS·Android, Slack. 내 컴퓨터에서 돌리는 세션은 2026년 2월 24일부터 폰으로 원격 조종이 됩니다.
다른 앱과 연결하는 방법은?
SDK와 연결 프로토콜을 이용합니다. Claude Agent SDK는 다른 프로그램에서 Claude Code를 실행하는 라이브러리이고, Codex App Server는 여러 화면을 실행 엔진과 연결합니다.
먼저 알고 싶은 것 · 2026.10.06 문서 확인
CLI 대신 SDK로 쓰면, 작업 능력이 달라질까?
파일 수정과 명령 실행은 가능합니다. 달라지는 것은 기본 설정과, 앱이 책임져야 하는 연결·권한·완료 처리입니다. 같은 엔진을 연결했다고 터미널의 모든 사용 경험이 자동으로 따라오는 것은 아닙니다.
여기서 SDK는 Claude Agent SDK와 Codex SDK를 뜻합니다. 모델 API를 호출하는 일반 Client SDK와 구분하며, Codex App Server는 별도의 앱 통합 인터페이스로 다룹니다. Claude 공식 비교 · Codex SDK
- 실제로 누가 작업하나
CLI: 사람이 터미널에서 에이전트를 조작합니다.
Claude Agent SDK: 앱이 Claude Code 실행 파일을 구동합니다. 파일·명령 도구, 에이전트 루프와 문맥 관리 능력을 사용합니다. 채팅 API에 답변만 요청하는 방식과는 구조가 다릅니다.
- 같은 질문인데 답이 다를 때
모델·추론 설정·작업 폴더·환경 변수·도구·대화 이력이 다르면 결과도 달라질 수 있습니다. Claude SDK는 시스템 프롬프트를 생략하면 최소 프롬프트를 사용합니다. CLI와 가까운 동작을 원하면
claude_code프리셋과 필요한 설정 소스를 확인해야 합니다.CLAUDE.md로딩은settingSources가 정합니다(프리셋과 무관). 현재 문서는 기본 로딩을 설명하지만, 빈 배열로 명시하면 로딩하지 않습니다. “SDK는 항상 설정을 읽지 않는다”는 설명도 정확하지 않습니다.- 권한과 도구
터미널에서는 승인 질문을 직접 봅니다. 통합 앱에서는 승인 요청을 화면에 표시하고 결정을 돌려줘야 합니다. 파일 쓰기·네트워크가 거부되었다면 모델 능력 부족인지 판단하기 전에 권한 설정을 확인해야 합니다.
Claude의
canUseTool은 모든 호출을 반드시 통과하는 관문이 아닙니다. 앞선 규칙에서 허용될 수 있으므로 모든 도구를 검사하려면 훅과 권한 평가 순서를 함께 봐야 합니다.- 세션과 지침 변경
이어하기는 이전 세션을 정확히 선택했을 때 의미가 있습니다. 복구 실패 뒤 새 세션을 만들면 이전 대화가 유지됐다고 표시하면 안 됩니다.
Claude는 기존 세션을 재개할 때 변경한 시스템 지침이 바로 적용되지 않고 압축 이후나 새 세션에서 적용되는 경우를 문서화하고 있습니다. 지침을 바꿨다면 실제 적용 여부도 확인해야 합니다.
- Codex SDK와 App Server
Codex SDK: 코드에서 작업·스레드를 시작하고 이어가는 라이브러리입니다.
App Server: 앱이 이벤트, 중단, 승인 요청과 대화 생명주기를 직접 연결하는 인터페이스입니다.
turn/completed라는 이벤트 이름만 보지 말고completed / interrupted / failed상태를 구분해야 합니다.
CLI와 SDK를 공정하게 비교하려면
같은 파일 사본, 같은 모델과 지침, 같은 도구·권한·환경에서 작은 작업을 각각 실행합니다. 결과 문장의 일치보다 변경 파일, 테스트 결과, 승인·중단·이어하기 동작을 비교합니다. 도구를 일부 끈 통합 앱과 모든 도구를 켠 CLI의 차이를 SDK 자체의 한계로 단정하지 않습니다.
오류와 한계
실제 오류는 있다. 다만 발생하는 층이 다르다
모바일 Remote Control, SDK의 프로세스 연결, 통합 앱의 구현을 구분해야 합니다. 모바일 연결 오류가 로컬 SDK 작업의 실패를 뜻하지는 않습니다.
아래 상태는 2026.10.06 확인한 GitHub 공개 화면 기준입니다. Open은 보고가 열려 있는 상태입니다. 최신 버전 재현 여부나 전체 사용자 해당 여부는 이 상태로 판정할 수 없습니다. 이 페이지에서는 해당 버그를 직접 재현하지 않았습니다.
SDK · 중단을 요청했는데 기다림이 끝나지 않는 보고
확인 화면: Open TypeScript SDK #425는 0.3.241·Linux에서 API 스트림 처리 중 interrupt()와 반복자가 끝나지 않는다는 보고입니다.
검증할 항목은 실제 종료 확인입니다. 중단 버튼을 누른 사실만으로는 부족합니다. 중단·연결 끊김·응답 없음은 완료와 다른 상태로 표시해야 합니다.
SDK · 입력 스트림 종료와 도구 결과 전달의 충돌
확인 화면: Open TypeScript SDK #348는 스트리밍 입력이 끝나는 시점에 제어 채널이 닫혀 MCP 호출 등이 Stream closed로 실패할 수 있다는 보고입니다. 본문의 재현 예시는 0.3.165를 사용합니다.
앱은 도구 호출 표시와 함께 도구 결과·최종 결과까지 확인해야 합니다. 설치 버전과 입력 방식이 보고의 조건에 해당하는지 먼저 대조합니다.
제품 문서에 적힌 원격 연결의 제약도 따로 있다
Claude Remote Control 공식 문서는 장시간 네트워크 단절 시 서버 모드와 대화형 세션의 복구 동작을 구분합니다. 서버 모드는 약 10분 뒤 프로세스가 종료될 수 있고, 대화형 세션은 네트워크 복귀를 기다려 재연결합니다. 모바일 첨부 파일이 전부 도착하지 않을 수도 있어 첨부 수신 여부도 확인해야 합니다.
공식 Remote Control 제한 사항. 옛 이슈 하나나 “최신 버전”이라는 말만으로 현재 상태를 판정하지 않습니다.
실제 작업을 믿을 수 있는 기준
그래서 지금 쓰는 앱에서 작업이 제대로 된 걸까?
SDK 연결 여부만으로 보증할 수는 없습니다. 실행 결과 → 실제 파일 → 검증 결과 → 반영 상태를 함께 확인해야 합니다.
실행이 정상적으로 끝났는가
Claude는 최종
result의subtype, Codex는 최종 턴 상태를 확인합니다. 글자가 출력됐거나 스트림이 닫힌 것만으로 성공 처리하지 않습니다. 최종 결과가 없으면 미확인·실패로 구분하고, 응답이 없는 경우에는 시간 제한과 복구 경로가 필요합니다.파일과 도구 결과가 남았는가
실제 변경 파일과 diff, 명령 종료 코드, 도구 오류를 확인합니다. 한 명령이 실패한 뒤 복구됐다면 마지막 검증 결과까지 봅니다. “수정했습니다”라는 답변만으로 파일 저장을 증명할 수는 없습니다.
요청한 기능이 검증됐는가
관련 테스트·빌드·화면 동작을 확인합니다. 엔진의 정상 종료는 요구사항 충족 판정과 다릅니다. 테스트가 모의 연결을 사용하는지도 표시해야 합니다. 모의 테스트 통과만으로 실제 API·장시간 세션·모바일 재연결까지 검증됐다고 말할 수 없습니다.
저장·반영까지 확인했는가
로컬 저장, 실행 앱 반영, 커밋, 원격 푸시는 서로 다른 단계입니다. 요청한 단계가 끝났는지 각각 확인합니다. 연결이 끊겼다면 재시도 전에 기존 변경과 실행 중인 작업을 확인해 중복 실행을 피합니다.
이 네 단계는 위 문서와 오류 보고를 바탕으로 정리한 검증 기준입니다. 특정 통합 앱이 전부 통과했다는 인증은 아닙니다. Claude 결과·오류 종류 · Codex 턴·도구 이벤트
앱 개발자에게 확인할 작은 재현 시나리오
임시 파일 작성·다시 읽기, 의도적으로 실패하는 명령, 승인 거부, 작업 중단, 세션 이어하기를 점검합니다. 이어서 최종 결과 없는 연결 종료, 응답 없음, 화면 새로고침·재접속 상황에서도 완료로 잘못 표시하거나 작업을 중복 실행하지 않는지 확인합니다.
모바일
폰에서 코딩 에이전트를 쓰게 된 순서
폰에서 쓰는 방식은 둘로 나뉩니다. 클라우드 작업은 회사 서버의 VM에서 돌고 폰은 지시만 합니다. 내 컴퓨터 원격 조종은 내 컴퓨터에서 도는 세션을 폰으로 보고 조종하는 방식이라 내 파일과 도구를 그대로 씁니다.
Claude Code
OpenAI Codex
Google (Jules · Antigravity)
속 빈 점 = 앱 없이 모바일 브라우저
클라우드 작업을 폰 앱에서
Codex가 2025년 5월 19일 ChatGPT iOS 앱에 들어갔습니다. Claude Code는 2025년 10월 20일 iOS 앱에 들어갔습니다. Google Jules는 전용 앱 없이 모바일 브라우저로 썼습니다.
내 컴퓨터 원격 조종: Claude Code가 먼저
Claude Code의 Remote Control이 2026년 2월 24일 나왔습니다. Codex는 약 11주 뒤인 5월 14일 미리보기, 6월 25일 정식이었고, Antigravity는 8월 21일 브라우저 전용으로 나왔습니다.
연표
터미널에서 폰까지, 세 회사 연표
꽉 찬 점은 화면이 새로 넓어진 순간입니다. 제목 아래 링크가 각 항목의 출처입니다.
처음
처음에 터미널이었던 이유, 만든 사람들의 말
“모델이 너무 빨리 바뀌어서”라는 말은 2차 요약 글에만 있어서 넣지 않았습니다. 아래는 원문을 확인한 인용입니다.
Claude Code는 의도적으로 저수준이고 특정 방식을 강요하지 않습니다. 정해진 작업 흐름을 강요하지 않고 모델에 거의 그대로 접근하게 합니다. 이 설계 덕분에 유연하고, 바꿔 쓸 수 있고, 스크립트로 묶을 수 있고, 안전한 도구가 됩니다.
“Claude Code is intentionally low-level and unopinionated, providing close to raw model access without forcing specific workflows.”
가장 쉬운 방법은 터미널에 작은 앱을 만드는 거였어요. 그러면 UI 같은 걸 만들 필요가 없었으니까요.
“the easiest way to do that was just building a little app in the terminal, because that way I didn't have to build a UI or anything.”
터미널에서 돌기 때문에 웹이나 데스크톱에서는 얻을 수 없는 것들에 접근할 수 있습니다. bash 명령을 실행하고, 현재 폴더의 모든 파일을 보고, 그걸 에이전트로서 스스로 해냅니다.
“Because it runs in the terminal, it has access to a bunch of stuff that you just don't get if you're running on the web or on desktop…”
이 분야는 너무 빨리 움직여요. 어떤 형태가 맞는지 아무도 몰라요. 그래서 CLI를 냈고, 그다음 IDE 확장을, 이제는 GUI로 된 새 IDE 확장을 냈죠.
“This stuff's just moving so fast, right? No one knows what these form factors are… So we have CLI, then we came out with an IDE extension. Now we have a new IDE extension that's a GUI.”
2025년 8월의 공식 문서도 “터미널에서 동작합니다. 또 하나의 채팅 창도, 또 하나의 IDE도 아닙니다”, “Unix 철학: 조합하고 스크립트로 묶을 수 있다”고 적었습니다. 지금 문서에도 Unix 철학 문장은 남아 있습니다.
구조
화면과 실행 엔진을 연결하는 방법
Claude Agent SDK와 Codex App Server의 역할을 간단히 정리한 개념도입니다. 특정 앱의 내부 구현을 재현한 그림은 아닙니다.
Claude Agent SDK
다른 프로그램에서 Claude Code를 사용하는 연결 도구
호스트SDK를 사용하는 애플리케이션요청 전달과 결과 표시
SDK 호출
연결Claude Agent SDKClaude Code 실행 파일을 구동하는 라이브러리
실행
엔진Claude Code파일과 도구를 사용해 작업 수행
OpenAI Codex 앱 · IDE 확장
OpenAI 공식 설명 기준 (2026.02.04)
화면Codex 앱 · VS Code 확장 · 웹CLI도 같은 엔진
양방향 JSON-RPC
연결Codex App Server여러 화면이 공유하는 프로토콜
같은 프로세스
엔진Codex 하네스스레드, 턴, 승인 요청
실행
로컬내 컴퓨터
클라우드Codex cloud
통합 예시
하나의 앱에서 두 에이전트 연결하기
공통 화면에서 사용할 에이전트를 선택하고, 연결 계층이 각 엔진에 맞는 방식으로 요청을 전달하도록 설계할 수 있습니다. 다음은 특정 서비스의 구현과 무관한 통합 설계 예시입니다.
공통 화면하나의 앱 · 두 에이전트에이전트 선택, 요청 입력, 진행 상황과 결과 표시
요청 전달
연결 계층선택한 에이전트로 요청 분기각 연결 방식에 맞춰 요청을 보내고, 응답과 승인 요청을 공통 화면으로 전달
두 가지 연결 경로
Claude 연결Claude Agent SDKSDK를 통해 실행과 응답 처리
실행
실행 엔진Claude CodeClaude 쪽 작업과 세션
Codex 연결Codex App ServerJSON-RPC로 요청과 응답 처리
실행
실행 엔진CodexCodex 쪽 작업과 스레드
통합하는 것은 조작 화면과 작업 흐름입니다. 두 엔진의 세션은 각각 관리하며, 대화 맥락이나 결과를 서로 전달하려면 연결 계층에서 별도로 처리하도록 설계합니다.
원격
폰에서 쓰는 방식 비교
| 방식 | 처음 나온 날 | 코드가 실행되는 곳 | 폰에서 쓰는 곳 | 연결 방법 |
|---|---|---|---|---|
| Codex 클라우드 | 2025-05-19 | OpenAI 클라우드 | ChatGPT iOS 앱 | GitHub 저장소를 클라우드에서 작업 |
| Jules | 2025-05-20 | Google 클라우드 VM | 모바일 브라우저 (전용 앱 없음) | GitHub 저장소를 클라우드에서 작업 |
| Claude Code 클라우드 | 2025-10-20 | Anthropic 관리 VM | Claude iOS 앱, 이후 Android | GitHub 복제. --teleport로 터미널에 가져옴 |
| Claude Code Remote Control | 2026-02-24 | 내 컴퓨터 | Claude iOS·Android 앱, claude.ai/code | claude remote-control 또는 /rc. 내 컴퓨터가 밖으로 연결 |
| Dispatch | 2026-03-17 | 내 데스크톱 | Claude 모바일 앱 | 폰에서 보낸 작업을 데스크톱 앱이 받아 실행. 3월 23일부터 Claude Code 세션도 시작. 현재 신규 사용자 제공 중단(기존 사용자만 계속 사용) |
| Codex Remote | 2026-05-14 | 내 Mac (6/25부터 Windows도) | ChatGPT iOS·Android 앱 | QR 코드로 짝짓기, OpenAI 보안 중계 |
| Antigravity Remote Control | 2026-08-21 | 내 컴퓨터 (데스크톱·CLI·헤드리스) | 모바일 브라우저 (전용 앱 없음) | Ultra 구독자부터 단계적 제공, 푸시 알림 |
GitHub Copilot 코딩 에이전트(2025.05.19, GitHub Mobile에서 작업 지정 가능)와 Happy·Termux 같은 제3자 도구는 이번 비교에서 뺐습니다.
출처
- Anthropic, Claude 3.7 Sonnet and Claude Code (2025.02.24)
- Anthropic, Introducing Claude 4 (2025.05.22)
- Claude Code CHANGELOG: 버전별 날짜는 npm 배포 시각으로 맞춤
- Anthropic, Claude Code 2.0 (2025.09.29)
- Claude, Claude Code on the web (2025.10.20)
- Anthropic, Claude Opus 4.5 (2025.11.24): 데스크톱 앱의 Claude Code 첫 공식 언급
- Noah Zweben (Anthropic), Remote Control 공개 글 (2026.02.24)
- Claude 앱 릴리스 노트: Cowork, Dispatch, Claude Tag
- Claude, Dispatch와 computer use (2026.03.23) · Dispatch 도움말: 신규 사용자 제공 중단 · 데스크톱 재설계 (2026.04.14)
- Claude Code Docs, Desktop · Agent SDK · Remote Control
- Latent Space, Claude Code (2025.05.07) · Every 팟캐스트 (2025.10.29)
- OpenAI, Introducing Codex · Codex 정식 출시 · Codex 앱 · App Server · Codex 원격 · Codex 변경 기록
- TechCrunch, Codex CLI (2025.04.16) · 9to5Mac, Codex 폰 원격 (2026.05.14)
- Google Antigravity 소개 (2025.11.18) · Antigravity 2.0 · Remote Control 발표 (2026.08.21) · Remote Control 문서 · GIGAZINE (2026.08.22)
- Google, Gemini CLI (2025.06.25) · TechCrunch, Jules 정식 (2025.08.06)