클로드 코드는 iOS를 지원하지 않으므로 리눅스 서버에 설치하고 아이폰은 Termius 같은 SSH 앱으로 접속해 화면 역할만 합니다. 설치는 curl -fsSL https://claude.ai/install.sh | bash 한 줄이면 되고 ~/.local/bin/claude 에 깔립니다. 명령을 못 찾을 때는 PATH보다 설치 여부를 먼저 확인하십시오. 클로드 코드는 Pro 이상 요금제가 필요합니다.
노트북을 안 들고 나온 날, 급하게 서버를 손볼 일이 생겼습니다. 아이폰밖에 없었어요.
결론부터 말하면 됩니다. 아이폰에서 SSH로 리눅스 서버에 접속하고, 거기에 클로드 코드를 깔아서 씁니다. 아이폰에 설치하는 게 아니라 서버에 깔고 폰은 화면 역할만 하는 거예요.
그런데 저는 여기서 3분을 헤맸습니다. 엉뚱한 데를 먼저 손댔거든요. 그 얘기까지 적겠습니다.
이 글은 2026년 8월 5일, 아이폰과 Termius, Debian 리눅스 서버 환경에서 직접 확인한 내용입니다. 클로드 코드 버전은 2.1.222였습니다.
준비물 — 아이폰, Termius, 리눅스 서버
세 가지가 필요합니다.
- 아이폰과 SSH 앱. 저는 Termius를 씁니다. SSH는 멀리 있는 컴퓨터에 안전하게 접속하는 방식이고, Termius는 그걸 폰에서 쓰게 해 주는 앱입니다
- 리눅스 서버. 제 것은 Debian이었습니다
- 그 서버에 접속할 계정과 주소
클로드 코드는 macOS와 리눅스, 윈도우에서 돌아갑니다. 리눅스는 Ubuntu 20.04 이상이나 Debian 10 이상이면 됩니다. iOS는 지원 대상이 아닙니다. 그래서 서버에 깔고 폰으로 들여다보는 방식이 되는 겁니다.
첫 벽 — command not found
Termius로 서버에 접속했습니다. 접속은 깔끔했어요. Debian 인사말이 뜨고 프롬프트가 나왔습니다.
그래서 바로 쳤습니다.
claude
claude 를 치니 명령을 못 찾습니다.PC에서는 잘 되던 명령인데 폰에서는 없다고 합니다. 여기서 제가 오해를 했어요.
PATH부터 손댄 3분
저는 PATH 문제라고 확신했습니다. PATH는 명령어를 어느 폴더에서 찾을지 적어 둔 목록이에요. 여기에 없는 폴더에 프로그램이 있으면 셸이 못 찾습니다. 설치는 돼 있는데 셸이 못 찾는 상황이라고 생각한 거죠. 흔한 증상이니까요.
그래서 .bashrc가 어떻게 생겼는지부터 봤습니다.
grep bash_aliases ~/.bashrc.bashrc가 .bash_aliases를 불러오는 구조더군요. 그럼 거기에 넣으면 되겠다 싶어서 이렇게 했습니다.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_aliases
.bashrc 가 .bash_aliases 를 읽는 구조라 거기에 PATH 를 넣었습니다. 하지만 이게 원인이 아니었어요.다시 접속해서 쳐봤습니다. 여전히 없다고 나왔어요. 로그인 기록을 보면 00시 54분에 한 번, 00시 57분에 또 한 번 접속했습니다. 그 3분이 헤맨 시간입니다.
진짜 원인 — 설치 한 줄
그제야 생각이 났습니다. 이 서버에는 애초에 클로드 코드를 깐 적이 없었습니다.
PC에 깔아 뒀으니 당연히 있을 거라고 넘겨짚은 겁니다. 서버는 완전히 다른 공간인데요. 없는 프로그램의 경로를 아무리 잡아 봐야 나올 리가 없었습니다.
공식 설치 명령은 한 줄입니다. curl은 인터넷에서 파일을 받아오는 명령이고, 뒤의 | bash는 받아온 것을 바로 실행하라는 뜻입니다.
curl -fsSL https://claude.ai/install.sh | bash앤트로픽이 권하는 기본 설치 방법입니다. macOS와 리눅스, WSL에서 이 한 줄이면 됩니다.
설치 확인 — 버전과 위치
몇 초 만에 끝났습니다. 화면에 이렇게 나왔어요.
Claude Code successfully installed!
Version: 2.1.222
Location: ~/.local/bin/claude설치 위치를 보십시오. ~/.local/bin/claude입니다. 제가 아까 PATH에 넣어 둔 바로 그 경로예요.
그래서 설치가 끝나자마자 claude가 바로 잡혔습니다. 헛수고는 아니었고 순서가 뒤바뀐 것이었습니다. 다만 순서를 지켰으면 3분을 안 썼겠죠.
설치가 잘됐는지는 이걸로 확인합니다.
claude --version뭔가 이상하면 claude doctor를 쳐 보십시오. 설치 상태와 설정을 읽기만 해서 진단해 줍니다.
제대로 된 순서
제 실수를 빼고 정리하면 이렇습니다.
- Termius로 서버에 SSH 접속
curl -fsSL https://claude.ai/install.sh | bash로 설치claude --version으로 확인- 안 잡히면 그때 PATH를 본다
PATH는 마지막에 봅니다. 「명령을 못 찾는다」는 말이 「설치돼 있는데 경로가 없다」는 뜻만은 아니거든요. 애초에 없을 수도 있습니다. 저처럼요.
설치하고 나면 claude를 치면 대화가 시작됩니다. 처음에는 브라우저로 로그인하라고 안내가 나옵니다. 네이티브로 설치하면 그 뒤로는 알아서 최신 버전으로 올라갑니다.
무료 요금제로는 안 되는 클로드 코드
중요한 조건이 하나 있습니다. 클로드 코드는 Pro나 Max, Team, Enterprise, 또는 Console 계정이 필요합니다. 무료 요금제에는 클로드 코드가 들어 있지 않습니다.
설치는 되는데 로그인에서 막히면 이걸 의심해 보십시오. 어느 요금제를 골라야 할지는 클로드 코드 요금제 비교에 적어 두었습니다.
이 글은 폰에서 접속하는 경우만 다뤘습니다.
출처 — 공식 문서와 제 화면
설치 명령과 요금제 조건, 지원 운영체제는 앤트로픽 공식 문서(code.claude.com/docs)에서 2026년 9월 2일에 다시 확인했습니다. 화면은 2026년 8월 5일 제 아이폰에서 찍은 것입니다.
정리하면 이렇습니다. 서버에 깔고 폰은 화면으로 쓴다. 명령을 못 찾으면 PATH보다 설치 여부를 먼저 본다. 그리고 무료 요금제로는 안 된다. 이 셋만 알면 헤맬 일이 없습니다.
자주 묻는 질문
아이폰에 클로드 코드를 직접 설치할 수 있나요?
안 됩니다. 클로드 코드는 macOS와 리눅스, 윈도우에서 돌아가고 iOS는 지원 대상이 아닙니다. 리눅스 서버에 설치하고 아이폰은 SSH로 접속해 화면 역할만 하는 방식으로 씁니다.
claude 명령을 못 찾는다고 나옵니다.
설치가 돼 있는지부터 확인하십시오. PATH 문제로 넘겨짚기 쉬운데, 서버에 아직 설치를 안 한 경우가 더 흔합니다. curl -fsSL https://claude.ai/install.sh | bash 로 설치한 뒤 claude --version 으로 확인하고, 그래도 안 잡히면 그때 PATH를 봅니다.
설치는 어디에 되나요?
~/.local/bin/claude 에 설치됩니다. 이 경로가 PATH에 없으면 설치가 끝나도 명령을 못 찾습니다. .bashrc 나 .bash_aliases 에 export PATH="$HOME/.local/bin:$PATH" 를 넣으면 됩니다.
무료 요금제로도 쓸 수 있나요?
쓸 수 없습니다. 클로드 코드는 Pro나 Max, Team, Enterprise, 또는 Console 계정이 필요합니다. 설치는 되는데 로그인에서 막힌다면 요금제를 확인해 보십시오.
