폰으로 조직 서버의 AI를 부리기
클로드 앱 원격조종(Remote Control), 서브도메인 없이 서버 세션에 닿는 길
품앗이 서버에서 2026년 10월 23일에 직접 개통하고 확인한 절차입니다. 조직 서버에 클로드 코드가 깔려 있고, 쓰는 사람에게 클로드 유료 좌석과 스마트폰 앱이 있는 현장을 위한 글입니다.
요지
스마트폰 클로드 앱에는 SSH 기능이 없습니다. 대신 서버에서 띄운 클로드 코드 세션을 폰 앱이 넘겨받아 조종할 수 있습니다. 서버의 파일과 사설망, 서버에 깔린 도구를 그대로 씁니다. 앤트로픽 안내에 따르면 서버는 바깥으로 나가는 연결만 쓰므로 포트를 열거나 도메인을 붙이지 않아도 됩니다.
1. 무엇이 되고 무엇이 안 되나
| 원격조종 | 서브도메인 웹 방 | |
|---|---|---|
| 필요한 것 | 그 사람의 클로드 유료 좌석과 앱 | 링크 하나 |
| 화면 | 클로드 앱 그대로 | 우리가 만든 화면 |
| 맞춤 기능(녹음 받아 적기 등) | 못 붙인다 | 붙일 수 있다 |
| 서버 쪽 준비 | 명령 한 줄과 로그인 | 웹 서버, 도메인, 터널 |
좌석과 앱이 있고 대화만 하면 되는 사람이라면 원격조종으로 충분합니다. 그 사람을 위해 웹 방을 따로 만들 이유가 없습니다. 좌석이 없는 사람이나 맞춤 기능이 필요한 방은 웹 방을 그대로 둡니다.
2. 서버에서 하는 일
- claude.ai 계정으로 로그인합니다. 원격조종은 claude.ai 구독 계정으로 로그인한 세션에서만 켜집니다.
setup-token같은 토큰 방식으로만 붙어 있는 서버에서는, 우리가 실행해 본 결과 「You must be logged in to use Remote Control」이 뜨며 거부됩니다.claude auth login --claudeai를 실행하면 주소가 하나 나옵니다. 그 주소를 쓸 사람이 폰에서 열어 승인하고, 화면에 뜬 코드를 서버에 넣으면 됩니다. - 이미 돌고 있는 세션이 있다면 설정 폴더를 따로 둡니다. 같은 서버에서 다른 AI 세션이 기존 인증으로 돌고 있으면, 새로 로그인하면서 그 인증 파일을 덮어쓸 수 있습니다.
CLAUDE_CONFIG_DIR변수로 원격조종 전용 폴더를 지정하면 기존 세션은 건드리지 않습니다. 지시문과 스킬은 기존 폴더를 심볼릭 링크로 이어 주면 됩니다. - 작업 폴더에서 원격조종을 띄웁니다.
claude remote-control --name <이름>을 실행합니다. 처음 한 번은 폴더를 신뢰할지, 원격조종을 켤지 묻습니다.Connected가 뜨면 준비가 끝난 것입니다. 이 서버 하나가 폰에서 여는 세션을 여러 개 받습니다. 우리 서버 화면에는 최대 32개로 나왔습니다. - 재부팅해도 다시 뜨게 합니다. tmux 안에서 띄우고, 부팅 때 그 tmux를 여는 시스템 서비스를 하나 등록합니다. 다만 tmux 안의 클로드만 죽으면 서비스는 그걸 모릅니다. 그때는 서비스를 다시 시작해야 합니다.
3. 폰에서 하는 일
- 클로드 앱 메뉴에서 Code로 들어갑니다.
- 「기기」 목록에서 서버 이름을 누르거나, 세션 목록에서 띄워 둔 이름을 누릅니다.
- 시험 삼아 「hostname이랑 지금 폴더 알려줘」를 보냅니다. 서버 이름과 서버의 작업 폴더가 나오면 연결된 것입니다.
4. 넘어진 자리
기기 목록이 비면 조직부터 본다
현장 기록을 보면, 서버는 Connected인데 폰의 기기 목록이 텅 비어 있었습니다. 이메일은 같았지만 폰 앱은 팀 조직에, 서버는 개인 조직으로 로그인되어 있었습니다. 기기 목록은 조직마다 따로 보입니다. 앱 설정 맨 위 계정 옆 ∨를 눌러 서버와 같은 조직으로 바꾸자 바로 나타났습니다. 목록이 비면 앱의 조직 이름과 서버가 로그인한 조직부터 맞춰 보십시오. 서버 쪽 조직 이름은 claude auth status의 orgName 칸에 나옵니다.
클라우드와 데스크톱 연결은 원격조종이 아니다
같은 날 기록에 따르면 두 번은 서버가 아닌 곳에 말을 걸었습니다.
- Code의 새 세션을 기기를 고르지 않은 채 열면 앤트로픽 클라우드의 임시 작업공간에서 돌아갑니다. 화면에 「환경 만들기」가 보이면 그쪽입니다.
- 일반 채팅 화면 위쪽의 「기기」는 PC에 깔린 클로드 데스크톱 앱을 잇는 다른 기능입니다. 원격조종이 아닙니다.
두 경우 모두 hostname이 vm, 폴더가 /home/claude로 나옵니다. 이 값이 보이면 서버에 닿지 않은 것입니다.
폰의 답만 믿지 말고 서버 쪽 기록을 본다
연결 여부는 서버에서 가립니다. 원격조종 세션이 쓰는 대화 기록 파일이 0바이트면 폰에서 보낸 말이 서버에 한 번도 오지 않은 것입니다. 우리 현장에서는 시험 메시지를 보낸 뒤 이 파일이 0바이트에서 수백 KB로 늘어난 것을 보고 성공으로 판정했습니다.