Claude Duet에서 Claude Code 연결하는 법: 휴대폰으로 진행 상황 확인·변경 승인·원격 이어가기 (서드파티 API Key 사용자용 대안 실측 포함)

Claude Duet 책임자 @davidsuttonca에 따르면 이제 Duet이 Claude Code 세션에 연결됩니다. 휴대폰에서 실행 중인 작업을 보고, 변경을 승인하고, 업데이트를 보낼 수 있으며 내 컴퓨터의 세션과 클라우드 세션을 모두 지원합니다. 이 글은 Anthropic 공식 문서를 바탕으로 이용 조건(구독 로그인, Remote Control, 클라우드 세션)을 정리하고, 서드파티 Base URL / API Key로는 쓸 수 없는 이유와 서버의 tmux + SSH로 Claude Code와 Codex를 원격 조작하는 대안을 실측합니다.

7 分钟阅读
Claude Duet에서 Claude Code 연결하는 법: 휴대폰으로 진행 상황 확인·변경 승인·원격 이어가기 (서드파티 API Key 사용자용 대안 실측 포함)

미국 시간 11월 6일, Claude Duet 책임자 David Sutton이 X에 Claude Duet이 이제 Claude Code 세션을 지원한다고 올렸습니다. 휴대폰에서 실행 중인 작업을 확인하고, 변경을 승인하고, 업데이트를 보낼 수 있으며 내 컴퓨터의 세션과 클라우드 세션 모두 지원합니다. Anthropic Claude Code 커뮤니티 팀의 @adocomplete가 이를 리포스트했고, Duet 엔지니어 @navbryce도 답글에서 피드백을 받고 있습니다.

핵심 요약:

  • 할 수 있는 것(@davidsuttonca 발표 기준): Duet에서 Claude Code 세션 진행 상황 보기, 변경 승인, 새 지시 보내기. 로컬과 클라우드 세션 모두 지원.
  • 누가 쓸 수 있나(Duet 공식 도움말 센터 기준): 현재 리서치 프리뷰로 미국의 Pro / Max / Ultra 사용자만, 대기자 명단 초대로 이용 가능. Team / Enterprise는 아직 미지원.
  • 로컬 세션 연결 방식: Claude Code 공식 문서에서 휴대폰과 로컬 세션을 잇는 통로는 Remote Control(claude remote-control 또는 /remote-control)입니다. claude.ai 구독 계정 로그인이 필요하고 API Key는 지원하지 않습니다.
  • 서드파티 Base URL / API Key 사용자: 공식 문서에 따르면 ANTHROPIC_BASE_URL이 api.anthropic.com 이외를 가리키면 Remote Control을 쓸 수 없습니다. 저희 Key로 재현해 보니 claude remote-control이 오류를 내고 종료됐습니다.
  • 대안: Claude Code / Codex를 서버의 tmux 안에서 돌리고, 휴대폰에서 아무 SSH 클라이언트로 접속해 진행 확인·승인·이어가기. 실측 결과 Claude Code는 버그 수정을 14초짜리 한 턴에, Codex exec는 비슷한 작업을 약 24초에 끝냈습니다.

Create API Key →

Duet에 추가된 기능 (공개 정보)

출처요점
@davidsuttonca (Claude Duet 공동 제작자·책임자)"Claude Duet: now with Claude Code sessions": 실행 중인 작업 확인, 변경 승인, 업데이트 전송을 모두 휴대폰에서. 컴퓨터와 클라우드 세션 모두 지원
@adocomplete (Anthropic, Claude Code 커뮤니티)리포스트: Claude Code in your Claude Duet
@daniel_mac8 (사용자)사용자 피드백에 따르면: Duet이 클라우드와 "연결된 기기"의 로컬 Claude Code 세션에 접근 가능
@navbryce (Duet 엔지니어)Claude Code Sessions 피드백 수집 중. 앱 안에서 Duet 클라우드 브라우저를 보는 기능 추가도 언급
X 트렌드 요약보도에 따르면: Duet과 Claude Code 세션이 연동되어 기기를 넘나들며 진행 확인과 작업 지시가 가능

참고: 이 글 게시 시점에 Duet 도움말 센터의 제한 사항에는 여전히 "컴퓨터의 모든 프로젝트나 파일을 볼 수 없고, Claude 안의 작업은 읽을 수 있지만 수정할 수는 없다"고 적혀 있으며, Claude Code 세션 연결 방법은 아직 별도로 안내되지 않았습니다. 아래 조건은 Claude Code 공식 문서를 기준으로 하며, Duet 안의 정확한 진입 경로는 앱 화면을 따르세요.

이용 조건 (공식 문서)

Duet

Get started with Claude Duet 기준:

  • Pro, Max, Ultra 중 하나의 플랜
  • 미국 Claude 계정
  • 대기자 명단 초대(순차 발송. 입력한 이메일이 Claude 계정, 휴대폰의 Apple / Google 계정과 같아야 함)
  • 사용량은 플랜 한도에 포함되며, 백그라운드 브리핑과 점검도 포함

클라우드 세션

Use Claude Code in the cloud 기준: 클라우드 세션은 Anthropic이 관리하는 인프라에서 실행되며 Pro / Max / Ultra / Team(또는 해당 Enterprise 좌석)과 GitHub 연결이 필요합니다. 노트북을 닫아도 작업은 계속되고 휴대폰에서 언제든 확인할 수 있습니다. 터미널에서는 claude --cloud "작업 설명"으로 시작합니다.

로컬 세션: Remote Control

Remote Control 문서와 Claude Code on mobile 기준:

bash
# 서버 모드: 프로젝트 폴더에서 실행. URL이 표시되고 스페이스바로 QR 코드 표시
claude remote-control

# 일반 대화형 세션을 원격 조작 가능하게 시작
claude --remote-control "My Project"

# 이미 세션 안에 있다면
/remote-control

그다음 Claude 앱의 Code 탭에서 세션을 선택합니다(온라인이면 초록 점이 있는 컴퓨터 아이콘). 공식 문서의 필수 조건:

  • 플랜: Pro / Max / Ultra / Team / Enterprise. API Key 미지원
  • 로그인: /login으로 claude.ai 계정 로그인. claude setup-token으로 만든 장기 토큰도 불가
  • 엔드포인트: Bedrock / Google Cloud / Foundry 사용 시, 또는 ANTHROPIC_BASE_URL이 api.anthropic.com 이외의 게이트웨이나 프록시를 가리키면 사용 불가
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 또는 DISABLE_GROWTHBOOK을 설정해도 사용 불가
  • 컴퓨터는 켜 두고 claude 프로세스도 계속 실행해야 함. 원격 머신에서는 tmux나 screen 사용 권장

연결되면 휴대폰에서 대화와 git diff를 보고 /model, /effort를 바꿀 수 있으며, 권한 모드는 Manual / Accept edits / Plan / Auto 중에서 고릅니다(Bypass 선택 불가). /plugin, /resume 같은 명령은 터미널에서만 됩니다. /config에서 푸시 알림을 켜면 작업이 끝나거나 승인이 필요할 때 휴대폰으로 알림이 옵니다.

서드파티 API Key로 연결되나? 실측

공식 문서에 이미 안 된다고 나와 있지만 직접 실행해 봤습니다. Claude Code 2.1.316, ANTHROPIC_BASE_URL은 https://api.aicodewith.ai, ANTHROPIC_AUTH_TOKEN에는 저희 Key:

text
$ claude remote-control
Error: You must be logged in to use Remote Control.

Remote Control is only available with claude.ai subscriptions. Run `claude auth login` to sign in with your claude.ai account.

1초도 안 되어 종료됩니다. 대화형 세션에서 /remote-control을 입력하면 Unknown command: /remote-control이 나옵니다. 조건이 맞지 않으면 명령 자체가 보이지 않습니다.

결론: Duet이나 Claude 앱으로 로컬 Claude Code를 조작하려면 claude.ai 구독 계정으로 로그인하고 서드파티 ANTHROPIC_BASE_URL을 제거해야 합니다. API Key로 게이트웨이를 쓰는 분은 아래 방법을 쓰세요.

Create API Key →

대안: 서버의 tmux + 휴대폰 SSH (Claude Code / Codex 모두 가능)

아이디어: 에이전트를 항상 켜져 있는 머신(클라우드 서버나 집 컴퓨터)의 tmux 세션에서 실행하고, 휴대폰은 아무 SSH 클라이언트로 접속합니다. tmux attach로 진행을 보고, Enter로 승인하고, 입력해서 이어갑니다. 연결이 끊기거나 화면이 잠겨도 작업은 멈추지 않으며, 다시 접속하면 세션이 그대로 있습니다.

1. Key 설정 (한 번만)

먼저 가입 후 API Key를 만듭니다(Create API Key 가이드 참고). Claude Code는 ~/.claude/settings.json에:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

Codex는 전역 ~/.codex/config.toml에:

toml
model = "gpt-6.1-sol"
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

자세한 설명은 Claude Code 서드파티 API 연결과 Codex config.toml 설정 가이드를 참고하세요.

2. tmux 안에서 에이전트 시작

bash
# Claude Code: 대화형 세션
tmux new -s cc -c ~/project
claude

# Codex: 다른 세션 (대화형은 codex, 일회성 작업은 codex exec)
tmux new -s cx -c ~/project
codex

Ctrl-b d로 빠져나와도 에이전트는 백그라운드에서 계속 실행됩니다.

3. 휴대폰에서 진행 확인·승인·이어가기

bash
ssh you@your-server

# 방법 1: 세션에 들어가기 (컴퓨터 앞에 앉은 것과 동일)
tmux attach -t cc

# 방법 2: 들어가지 않고 최근 40줄만 보기
tmux capture-pane -p -t cc | tail -40

# 승인 / 대화상자 확인: Enter 보내기
tmux send-keys -t cc Enter

# 새 지시 보내기
tmux send-keys -t cc "테스트 돌리고 실패하면 고쳐줘" Enter

화면이 작은 휴대폰에서는 방법 2가 가장 편합니다. 명령 하나로 진행 확인, 명령 하나로 승인이나 이어가기.

4. 실측 기록

Linux 서버에서 버그 하나만 있는 새 저장소(calc.py의 add가 a-b)를 만들고, 모두 저희 Key로 실행:

테스트조작결과시간
Claude Code (tmux 대화형 세션, claude-sonnet-5-5)tmux send-keys로 "add 고치고 python3로 검증"return a+b로 수정, add(2,3) 출력 5상태 줄 기준 한 턴 14초
원격 승인도중에 auto mode 안내 대화상자가 한 번 뜸, tmux send-keys Enter로 확인이어서 실행, 작업 완료명령 하나
Codex 0.167 (codex exec -s workspace-write, gpt-6.1-sol)tmux 안에서 "mul 고치고 검증"return a*b로 수정, mul(2,3) 출력 6약 24초
Claude Code 헤드리스claude -p "최근 두 커밋 요약" (읽기 전용)각 커밋이 추가한 파일과 함수를 정확히 답함약 11초

Claude Code 실제 출력(발췌):

text
● Update(calc.py)
  ⎿  Added 1 line, removed 1 line
      2 -    return a-b
      2 +    return a+b
● Bash(python3 -c "from calc import add; print(add(2,3))")
  ⎿  5
  ⎿  Allowed by auto mode

도중에 뜬 대화상자는 게이트웨이를 거칠 때 나오는 auto mode 분류기 과금 관련 일회성 안내입니다(auto mode는 그대로 동작). 배경은 Claude Code auto mode 게이트웨이 403/422를 참고하세요.

Codex 실제 출력(발췌):

text
apply patch
-    return a+b
+    return a*b
exec
/bin/bash -lc "python3 -c 'from m import mul; print(mul(2,3))'"
 succeeded in 0ms:
6

5. 더 "휴대폰 리모컨"처럼 쓰기

어떤 방법을 고를까

상황추천
미국 Pro / Max / Ultra, Duet 초대 받음, Claude Code를 claude.ai로 로그인Duet 또는 Claude 앱 Code 탭에서 바로 조작
구독은 있지만 미국 외 지역 / Duet 초대 없음Claude 앱 Code 탭 + Remote Control (역시 claude.ai 로그인 필요)
API Key 또는 서드파티 Base URL (저희 포함)서버 tmux + 휴대폰 SSH. 이 글에서는 Claude Code / Codex로 실측, 다른 CLI 에이전트도 같은 방식

자주 묻는 질문

Duet과 Claude 앱의 Code 탭은 같은 건가요?

아닙니다. Duet은 별도 앱(리서치 프리뷰)입니다. Claude Code 공식 문서에서 휴대폰으로 Claude Code를 조작하는 표준 경로는 Claude 앱의 Code 탭(클라우드 세션 + Remote Control)입니다. @davidsuttonca에 따르면 이제 Duet도 Claude Code 세션에 연결할 수 있습니다.

ANTHROPIC_BASE_URL을 설정해 뒀는데, 잠시 빼면 Remote Control을 쓸 수 있나요?

공식 문서에 따르면 조건에 맞는 claude.ai 구독으로 로그인했다면 ANTHROPIC_BASE_URL(settings의 env 안 같은 항목 포함)을 제거하고 세션을 다시 시작하면 됩니다. 이때 요청은 구독으로 처리되고 서드파티 Key는 쓰이지 않습니다.

tmux 방식에는 휴대폰에 어떤 앱을 쓰나요?

SSH 클라이언트라면 무엇이든 됩니다. 이 글은 특정 앱에 의존하지 않습니다. 중요한 건 항상 켜진 서버와 tmux 안의 에이전트입니다.

Codex에도 비슷한 방법이 있나요?

이 글에서는 Codex CLI를 tmux 안에서 돌리고 휴대폰에서 SSH로 이어받았습니다. Claude Code와 같은 방식입니다.

정리

Claude Duet 책임자 @davidsuttonca에 따르면 Duet은 이제 로컬과 클라우드의 Claude Code 세션에 연결해 휴대폰에서 진행 확인·승인·이어가기를 할 수 있습니다. 공식 문서상 이 경로는 claude.ai 구독 로그인이 필요하고 API Key와 서드파티 ANTHROPIC_BASE_URL은 지원하지 않습니다. 저희 Key로 시험하자 claude remote-control은 오류로 종료됐습니다. API Key 사용자는 Claude Code / Codex를 서버의 tmux에 두고 휴대폰에서 SSH로 확인·승인·이어가면 됩니다. 실측에서 Claude Code는 14초짜리 한 턴, Codex는 약 24초 만에 버그 수정과 검증을 마쳤습니다.

Create API Key →

관련 글: Claude Code 서드파티 API 연결 · git worktree로 Claude Code / Codex 병렬 실행 · Agent Autoloop 백그라운드 실행 · Codex config.toml

相关文章

UI SDK는 무엇이고 어떻게 쓰나? Vercel과 shadcn이 Agent를 위해 만든 동작 라이브러리를 Claude Code / Codex / Cursor에서 설치하고 실측하기 (0.1.0-beta.1)

UI SDK는 무엇이고 어떻게 쓰나? Vercel과 shadcn이 Agent를 위해 만든 동작 라이브러리를 Claude Code / Codex / Cursor에서 설치하고 실측하기 (0.1.0-beta.1)

UI SDK는 Vercel이 2026년 11월 12일에 공개한 Agent용 동작(behaviors) 라이브러리이며, 버전은 0.1.0-beta.1입니다. 동작은 프레임워크에 의존하지 않는 @ui-sdk/core에 있고, React, Vue, Svelte, Solid, Web Components 어댑터가 렌더링합니다. 공식 문서를 따라 무엇인지, 어떻게 설치하는지, Claude Code / Codex / Cursor에 skill을 어떻게 넣는지 정리하고, 테스트 머신에서 실제로 실행한 명령, 소요 시간, 출력을 기록합니다.

AWS Emulator란? 설치 방법과 Claude Code / Codex로 AWS 앱을 로컬에서 테스트하는 법 (1.0.322 실측)

AWS Emulator란? 설치 방법과 Claude Code / Codex로 AWS 앱을 로컬에서 테스트하는 법 (1.0.322 실측)

AWS Emulator는 AWS 공식 로컬 AWS 에뮬레이터로, 2026년 11월 11일(미국 시간)부터 정식 출시(GA)되었습니다. 추가 서비스 요금이 없고 소스가 공개되어 있으며 AWS 계정 없이 200개가 넘는 서비스를 다룹니다. 이 글에서는 Debian 13에서 1.0.322를 직접 테스트해 설치 명령, AWS CLI를 로컬 endpoint로 향하게 해 S3 버킷과 DynamoDB 테이블을 만드는 과정, 실제로 만난 오류, 그리고 Claude Code·Codex·Cursor가 에뮬레이터를 상대로 코드를 짜고 테스트하게 하는 방법을 정리합니다.

T3 Code란? 설치 방법, Claude Code·Codex 연결, 서드파티 API Key 설정과 자주 나는 오류 (0.1.9 실제 테스트)

T3 Code란? 설치 방법, Claude Code·Codex 연결, 서드파티 API Key 설정과 자주 나는 오류 (0.1.9 실제 테스트)

T3 Code는 pingdotgg가 공개한 오픈소스 코딩 에이전트 콘솔입니다. 자체 모델 없이, 컴퓨터에 이미 설치된 Claude Code, Codex, Cursor 등의 CLI를 조작합니다. Linux에서 T3 Code 0.1.9를 테스트해 설치 명령, Claude Code와 Codex를 AICodeWith API Key에 연결해 T3 Code가 조작하도록 하는 설정, t3 thread 명령으로 두 에이전트를 실제로 돌린 결과, 실제로 만난 오류와 해결 방법을 정리했습니다.