요즘은 업무적으로나 개인적으로 Claude Code를 사용할 일이 있어서 가끔 활용하고 있습니다. 근데 Claude Code를 본격적으로 사용하려면 아무래도 맥에서 사용하는게 제일 확실하다보니 이 경우에는 아이패드를 내려놓고 맥북을 주로 사용하게 됩니다.
근데 그러다가 아이패드 프로에서도 Claude Code를 사용할 수 있는 방법이 있지 않을까 싶어졌습니다. 하지만 결론부터 말하자면 당연히 CLI 기반의 Claude Code는 아이패드 프로에서 실행할 수 있는 방법이 없습니다.
Claude는 앱, 웹 인터페이스를 통해 Github에 업로드된 프로젝트에 연결해서 Claude Code를 실행할 수 있도록 하고 있긴 하지만 이 경우 매번 프로젝트를 Github에 올려야하는 불편함이 있습니다. 그냥 굳이 맥북 열지 않고도 Claude Code를 사용할 수 있는 방법이 필요했죠.
결론부터 말하자면 아이패드에서 네이티브로 Claude Code를 실행할 수 있는 방법은 없습니다. 원격에서 실행해서 써야합니다. 그러기 위해서는 서버 역할을 하는 컴퓨터가 필요합니다.
제 경우 운 좋게도 잠자기에만 들어가면 커널 패닉이 일어나서 항상 켜놓고 있는 아이맥이 있었습니다. 이 아이맥을 통해 아이패드에서 SSH로 맥에 원격으로 접속해 Claude Code를 사용해보는 겁니다.
다만 맥OS 쪽에는 ssh가 기본적으로 접근이 막혀 있습니다. 맥OS에서 ssh 접근을 활성화하려면 설정 > 공유 에서 원격 로그인을 활성화해줘야 합니다.

일단 여기까지하면 서버 쪽 설정은 마무리 됩니다.
아이패드 프로 쪽에는 ssh로 접속할 수 있는 터미널이 필요한데, 앱스토어에서 a-shell 이라는 앱을 이용해 CLI 환경을 사용할 수 있습니다. ssh나 파이썬 등 기본적인 명령어를 내장하고 있는 iPadOS 용 터미널 환경입니다.
a-shell 앱에는 기본적으로 ssh가 내장되어있으므로 ssh 명령을 다음과 같이 입력해 아이맥으로 접속하면 됩니다.
ssh username@192.168.0.10
username에는 맥OS에 로그인하는 계정을 입력하면 됩니다. 뒤에는 내부 IP 주소를 입력해서 접속하면 됩니다. 공유기가 연결되어있는 내부 네트워크에 접속할 때는 이 정도만 해도 충분히 사용할 수 있습니다.
외부에서 접속할 때는 DDNS나 포트 설정 등을 추가로 해주는게 보안적으로 안전합니다. 해당 설정 방법은 이 글에 더 자세히 나와있으므로 참고해주세요. 저도 해당 글을 이용해서 설정했습니다.
ssh를 통해 외부 망에 접속하면 a-shell 의 커맨드가 맥과 동일하게 바뀝니다.
[~/Documents]$ ssh username@192.168.0.10 // 아이패드 로컬에 실행중인 상태
username@usernameui-imac ~ % //ssh 실행 후 맥OS 쉘로 바뀐 상태
쉘이 위와 같이 바뀌면 ssh를 통해 서버 맥에 성공적으로 접속한 겁니다.
그 다음 과정부터는 맥OS에서 하는 것처럼 동일하게 사용하면 됩니다. Claude Code 설치 명령을 실행해서 claude code를 설치해줍니다. 분명히 해둘 건 이 과정은 원격으로 진행되는 것이기 때문에 아이패드에 설치되는게 아니라 원격의 아이맥에 설치되는 과정이라는 겁니다.
curl -fsSL https://claude.ai/install.sh | bash
설치 후 claude 명령을 실행해보면…

아이패드에서도 Claude Code가 실행됩니다. Jump Desktop이나 VNC를 사용하는 것보다 터미널에서 직접 사용하는 방식이기 때문에 네트워크의 영향을 적게 받고 빠르다는 장점이 있습니다. 정말 아이패드 프로에서 사용하는 것 같은 착각이 듭니다.

프로젝트 같은 경우 iCoud를 통해 동기화 되기 때문에 조금 시간이 걸리긴 하지만 아이패드 프로에서도 볼 수 있습니다. 원격에서 Claude Code로 파이썬을 코딩하면 iCloud로 동기화 되어 아이패드에서 파이썬 명령으로 로컬에서 파이썬을 실행하는 것도 가능합니다.
막상하고보니 굳이 이렇게까지 해서 아이패드 프로에서 실행시켜야하나 싶기는 한데(…) 그래도 실행해보니 개념은 재미있었습니다. 마침 항상 켜져있는 아이맥이 있었으니 가능한 삽질이었습니다.
ssh로 연결하는 환경을 뚫은 김에 외부에서 아이맥을 통해 게임 데스크탑의 WOL을 실행시키는 것도 해봤습니다. 명령어를 iOS 단축어로 실행하니 굳이 iptime 앱을 실행하는 삽질 없이 할 수 있어서 좋았습니다. 개발자 분들이 라즈베리 파이로 홈서버 세팅을 해두시던데 그 마음을 알 것 같았습니다.
만약 나중에 아이맥이 수명을 다하면 집에 있는 스팀덱으로 비슷하게 세팅해보는 것도 재밌을 것 같습니다.
댓글을 달려면 로그인해야 합니다.