iPhone에서 Claude Code 사용하기: Mac, Windows, Linux 설정 가이드

개발 컴퓨터에 Claude Code를 설치하고 로그인까지 마쳤습니다. 이제 iPhone에서 질문을 보내거나 진행 상황을 읽고, 결정이 필요한 부분에 답하고 싶습니다. Tactic Remote를 사용하면 컴퓨터가 Claude Code를 실행하고 프로젝트 파일을 보관합니다. 휴대폰은 해당 호스트에 연결해 대화 인터페이스를 제공합니다.

이 가이드는 Tactic Remote 1.10에서 Claude Code 대화를 만드는 과정을 설명합니다. 다른 클라이언트의 대화가 자동으로 가져와진다고 가정하지 않습니다. Anthropic의 앱에서 기존 Claude Code 세션을 이어가는 것이 목적이라면 공식 Remote Control도 고려해 보세요.

컴퓨터에서 프로젝트가 정상적으로 작동하는지 확인하기

컴퓨터의 터미널에서 대상 프로젝트를 열고 평소처럼 Claude Code를 실행합니다. 파일을 변경하지 않고 프로젝트를 설명해 달라고 요청하세요. 로그인이나 시작 과정에서 문제가 발생하면 휴대폰을 연결하기 전에 먼저 해결합니다.

두 서비스의 역할을 구분하세요. Claude Code는 자체 인증과 사용 한도를 이용합니다. Tactic Remote에 로그인하면 Tactic 계정 기능을 사용할 수 있지만, Claude Code에 대신 로그인해 주지는 않습니다.

다운로드 페이지에서 iPhone 앱과 호스트에 맞는 소프트웨어를 받으세요. 현재 제공되는 버전에 명시된 요구 사항을 확인한 다음, 실제로 작업을 실행할 컴퓨터에 해당하는 절차를 따릅니다.

Mac: 같은 Wi-Fi에서 컴패니언 앱과 페어링하기

Mac 컴패니언 앱을 설치하고 실행합니다. 이 앱에는 로컬 서버와 Node.js 런타임이 포함되어 있으므로, 앱을 사용하는 이 방식에서는 Node를 별도로 설치할 필요가 없습니다. 컴패니언 앱에 표시되는 의존성 확인 안내를 따르고 서버가 실행 중인지 확인하세요.

처음 연결할 때는 Mac과 iPhone을 같은 Wi-Fi에 연결합니다. iPhone 앱의 설정 화면에서 **Scan QR Code(QR 코드 스캔)**를 누르고 Mac 컴패니언 앱에 표시된 연결 코드를 스캔하세요. 연결한 뒤 호스트 이름을 확인합니다.

페어링에 실패하면 휴대폰에서 Mac에 접근할 수 있는지 확인하세요. 게스트 네트워크는 두 기기에 같은 Wi-Fi 이름이 표시되더라도 기기 간 통신을 차단할 수 있습니다. 주소와 연결 확인 방법은 로컬 네트워크 가이드를 참고하세요. 로컬 페어링에 성공했다고 해서 셀룰러 데이터로도 접근할 수 있는 것은 아닙니다.

Windows: PC를 연결 등록하고 계정으로 접속하기

Windows 계정 및 Relay 가이드에서 요구하는 Windows 컴패니언 앱과 모바일 앱 버전을 사용하세요. 이 방식에는 서로 호환되는 1.10 버전이 필요하며, 이전 빌드에 같은 기능이 표시된다고 가정해서는 안 됩니다.

Windows 컴패니언 앱에서 **Account(계정)**를 열고, 브라우저에서 Tactic 로그인을 완료한 뒤 앱으로 돌아옵니다. 필요한 경우 **Bind this PC(이 PC 연결 등록)**를 선택하세요. Tactic Relay를 활성화하고 연결된 상태가 표시될 때까지 기다립니다.

iPhone에서 같은 Tactic 계정으로 로그인한 뒤 **Your Computers(내 컴퓨터)**를 열고 해당 PC를 선택하세요. 컴패니언 앱은 계속 실행해 둡니다. C:\Projects 아래에 둔 저장소처럼 Windows 호스트의 프로젝트 디렉터리를 선택하세요. 가상 머신이 제공하는 공유 폴더를 선택해도 Agent가 실행되는 운영체제가 바뀌지는 않습니다.

Linux: 문서에 따라 CLI 서버 실행하기

Linux에서는 시작하기에 설명된 터미널 기반 서버 방식을 사용합니다. 문서의 구성에는 Node/npm, tmux, 정상적으로 작동하는 Agent CLI가 필요합니다. 사용하려는 Claude Code 로그인 상태와 프로젝트 접근 권한을 가진 사용자로 서버를 시작하세요.

npx tacticremote

iPhone 앱에서 서버가 제공하는 연결 QR 코드나 주소를 사용합니다. 처음 로컬로 연결할 때는 휴대폰이 Linux 호스트에 접근할 수 있어야 합니다. 클라우드 VM의 사설 주소는 QR 코드를 스캔하는 것만으로 접근 가능해지지 않습니다. 호스트가 다른 네트워크에 있다면 접근 가능한 원격 연결 경로를 설정하세요. 휴대폰을 사용하는 동안 서버 프로세스를 계속 실행해 둡니다.

저장소와 Claude Code 선택하기

올바른 호스트에 연결한 뒤 프로젝트 홈 오른쪽 아래의 **New Conversation(새 대화)**을 누릅니다.

입력창 아래의 프로젝트 버튼 또는 **Independent Workspace(독립 작업 공간)**를 누르세요. 실제 저장소 디렉터리를 선택하고, 목록에 없다면 **Choose another folder(다른 폴더 선택)**를 사용합니다. Independent Workspace는 별도의 디렉터리를 만들기 때문에, 메시지에 프로젝트 이름을 언급하는 것만으로 기존 저장소가 선택되지는 않습니다.

다음으로 입력창 아래의 Agent 버튼을 누르고 Claude를 선택하세요. 첫 요청을 보낼 때는 입력창 위의 상호작용 메뉴를 Chat으로 유지합니다. 명령줄과 직접 상호작용해야 할 때는 네이티브 터미널 모드도 사용할 수 있습니다.

생성 화면에서는 이러한 선택 사항을 준비합니다. 첫 메시지를 전송하면 Agent가 시작됩니다.

첫 요청은 쉽게 확인할 수 있도록 만들기

다음과 같이 보냅니다.

파일을 수정하지 말고 이 프로젝트를 살펴봐 주세요. 작업 디렉터리와 Git 브랜치를 알려 주고, 앱 실행 방법을 설명한 뒤 테스트 명령을 찾아 주세요. 아직 테스트를 실행하거나 의존성을 설치하지는 마세요.

응답을 컴퓨터에서 열어 둔 프로젝트와 비교하세요. 가장 먼저 확인할 것은 올바른 디렉터리와 브랜치에서 나온 출력이 보이는지입니다. Claude가 로그인, 시작 단계의 입력, 권한 확인을 기다리고 있다면 휴대폰 연결이 실패했다고 단정하지 말고 해당 안내를 처리하세요.

그다음 구체적인 후속 질문 하나를 선택합니다. 예를 들면 다음과 같습니다.

빈 검색 입력을 처리하는 함수를 읽어 주세요. 빈 문자열과 공백만 들어 있는 문자열을 입력했을 때 각각 어떤 일이 일어나는지 설명하고, 해당 파일과 함수를 알려 주세요. 아직 수정하지는 마세요.

이 예시는 본인 프로젝트에서 이해해야 하는 동작으로 바꿔 사용하세요.

디렉터리와 브랜치를 확인했다면 휴대폰으로 버그 수정을 진행하는 사례에서 수정 범위를 정하고 결과를 검증하는 과정을 살펴보세요.

자리를 떠나기 전에 다른 네트워크에서 연결해 보기

Mac이나 Linux를 로컬 Wi-Fi 밖에서 사용하려면 먼저 Cloudflare Tunnel 설정과 같은 원격 연결 경로를 구성하세요. 터널의 현재 주소와 필요한 인증을 사용해야 하며, 임시 터널 주소는 다시 시작한 뒤 바뀔 수 있습니다. Windows에서는 앞서 설정한 Relay 연결을 확인하세요.

아직 호스트 상태를 직접 확인할 수 있을 때 iPhone을 셀룰러 데이터로 전환하고 다시 연결하세요. 호스트는 잠자기 상태로 전환되지 않아야 하며 서버도 계속 실행 중이어야 합니다. 휴대폰 앱을 닫는 것만으로 Agent가 작업을 완료했는지는 알 수 없습니다. 같은 호스트와 대화를 다시 열어 최신 상태를 확인하세요.

이 읽기 전용 질문 하나부터 시작하세요. Tactic Remote를 다운로드하고 호스트에 맞는 방식으로 연결한 뒤, Claude Code에 변경을 요청하기 전에 프로젝트를 확인하세요.