휴대폰에서 Claude Code 또는 Codex 사용

Otter Digital Pte. Ltd. · 2026년 9월 30일 업데이트

Otter Beam을 쓰면 휴대폰으로, Mac이나 Linux 또는 Windows 컴퓨터에서 실행 중인 Claude Code나 Codex에 연결할 수 있습니다. 컴퓨터를 호스트로 설정하고, 휴대폰을 승인한 다음, 프로젝트와 그 채팅을 엽니다. 에이전트와 파일은 컴퓨터에 있습니다.

연결하기 전에 필요한 것

Otter Beam이 설치되고 호스트 설정이 끝난 Mac, Linux 또는 Windows 컴퓨터. 그 컴퓨터의 전원을 켜 두고, 깨어 있게 하고, 네트워크에 연결해 둡니다.
그 컴퓨터에서 Claude Code 또는 Codex를 쓸 수 있고, 각각의 로그인이 끝나 있어야 합니다. 공식 Claude Code 빠른 시작 또는 Codex CLI 설정을 따릅니다. Otter Beam 계정이 에이전트 제공자의 계정이나 이용 조건을 대신하지는 않습니다.
휴대폰의 Otter Beam 또는 Otter Beam 웹 앱, 그리고 기기를 연결할 Otter Beam 계정.

호스트는 공식 macOS 다운로드, Linux 다운로드와 요구 사항 또는 Windows 다운로드와 안내에서 받습니다. 휴대폰 앱은 App Store와 Google Play에 있습니다.

휴대폰에서 첫 채팅 열기

컴퓨터에서 호스트를 설정합니다. 휴대폰에서 연결하기 전에 Otter Beam 호스트 설정을 마칩니다. 휴대폰은 이 컴퓨터에 연결할 뿐, 데스크톱 에이전트를 휴대폰에서 실행하지는 않습니다.
로그인하고 휴대폰을 승인합니다. 같은 Otter Beam 계정으로 로그인합니다. Otter Beam이 이 새 기기의 승인을 요청하면, 이미 신뢰하는 기기에서 승인을 마칩니다. 앱에 표시된 설정을 따릅니다. 첫 기기는 승인해 줄 기존 신뢰 기기가 없습니다.
컴퓨터와 프로젝트를 고릅니다. 작업할 폴더를 프로젝트로 엽니다. 여러 머신에 비슷한 폴더가 있으면, 의도한 컴퓨터의 것인지 확인합니다.
채팅을 열거나 New chat을 고릅니다. 이어 가려면 기존 Claude Code 또는 Codex 채팅을 고릅니다. 별도 작업은 그 프로젝트에서 쓸 수 있는 에이전트로 새 채팅을 시작합니다.
답을 읽고 다음 지시를 보냅니다. 지원되는 에이전트 채팅은 채팅 보기에서 프롬프트, 답변, 도구 실행 내역을 보고, 터미널 보기에서 그 에이전트의 터미널 화면을 봅니다. 별도의 터미널이 자동으로 에이전트 채팅이 되지는 않습니다. 쓸 수 있는 보기와 조작은 harness마다 다릅니다.

워크스페이스 그림 가이드에 프로젝트 레일, 채팅 목록, 대화, 하단 도구가 나옵니다. 프로젝트와 채팅의 차이는 Otter Beam의 프로젝트와 채팅을 읽습니다.

Wi-Fi를 벗어나면 어떻게 됩니까?

연결할 수 있는 로컬 네트워크나 Tailscale 같은 VPN에서는 Otter Beam이 SSH로 직접 연결할 수 있습니다. 그 네트워크 밖에서는 Otter Relay가 암호화된 연결을 전달할 수 있습니다. Otter Relay는 내 컴퓨터로 가는 연결 경로이며, 에이전트의 작업을 Otter 서버로 옮기지는 않습니다.

휴대폰 연결이 끊겼다고 해서, 호스트의 tmux 안에서 실행 중인 에이전트가 멈추지는 않습니다. 다시 연결해 채팅으로 돌아오면 됩니다. 호스트가 종료되거나 재부팅되거나, 프로세스가 끝나거나 전원이 끊기면 작업은 이어지지 않습니다. Otter Relay 세션 허용 시간은 요금제에 따라 다릅니다. 요금제에서 확인합니다.

채팅이 보이지 않으면

먼저 호스트에 연결되는지, 휴대폰이 승인되었는지, 고른 프로젝트가 맞는 컴퓨터와 폴더를 가리키는지 확인합니다. 컴퓨터에 터미널 창이 열려 있다는 것만으로 그 프로세스가 Otter Beam에서 찾을 수 있는 채팅이 되지는 않습니다. 같은 작업을 새로 시작하기 전에 채팅이 안 보일 때 점검 목록을 확인합니다.

Windows 호스트 설정은 WSL 2를 쓰고 SSH로 원격 접근을 켭니다. Linux의 원격 디스플레이 설정은 에이전트의 채팅이나 터미널을 쓰는 것과 별개입니다. Windows 안내와 Linux 제한을 확인합니다.

설정에 도움이 필요합니까?

플랫폼, 앱 버전, 연결 방식, 실패한 단계를 적어 Otter Beam 지원에 연락합니다. 비밀번호, 개인 키, 액세스 토큰, 비공개 채팅 내용은 넣지 마십시오.

Otter Beam은 Otter Digital Pte. Ltd.가 만들며, 에이전트 제공자와 제휴하지 않고 그 보증을 받지도 않습니다. Otter Beam 살펴보기 또는 웹 앱 열기.