Replit을 사용하여 모바일에서 Claude Code를 실행하는 방법

이 가이드는 5 분 이내와 500 단어 이내로 휴대폰에서 Claude Code 를 실행하는 방법을 알려드립니다. 시작하려면 다음이 필요합니다:

노트북에서 시작하는 것이 가장 쉽습니다. 먼저 이 템플릿으로 이동한 다음 Remix 를 클릭하세요.

Matt 의 Claude 템플릿

오른쪽 하단에 Secrets 가 누락되었다는 메시지가 표시됩니다. 이를 클릭하면 Secrets 창으로 이동합니다.

/home/runner/workspace/.claude-user (따옴표 제외)를 CLAUDE_CONFIG_DIR 값으로 붙여넣으세요. "Add Secret"을 클릭하는 것을 잊지 마세요.

이제 "Secrets" 탭 옆에 있는 더하기 아이콘을 클릭하고 "Shell"을 검색하세요.

도구에서 Shell 검색

Shell 을 열고 "claude"를 입력하세요. 짜잔! Claude Code 가 실행됩니다.

Anthropic 으로 로그인하세요. 클릭한 링크에서 인증하지 말고, 대신 URL 을 복사/붙여넣기 하세요.

인증 프롬프트를 따르세요. 새 창이 열리고 인증을 요청하면 클릭하지 말고 대신 터미널로 돌아가면 URL 이 있습니다.

URL 을 복사/붙여넣기하고, 결과 코드를 가져와 터미널에 붙여넣으세요.

이제 재미있는 부분입니다.

휴대폰에 Replit 모바일 앱을 설치하세요.

열고 로그인하세요. 이전에 만든 앱이 보일 것입니다. 선택하세요.

오른쪽 하단의 "세 개의 사각형" 아이콘을 클릭하여 도구를 여세요.

"Shell"을 검색하세요. 탭하세요!

이제 로그인되었으니 휴대폰을 열 수 있습니다!

왼쪽 상단의 Shell 선택기를 탭하세요. 이전에 실행한 "claude" 명령어가 보일 것입니다.

모바일에서 Shell 열기

짜잔! Claude Code 가 휴대폰에서 실행됩니다... 데스크톱 버전과 동기화된다는 점을 눈치채셨을 수도 있습니다! (자세한 내용은 아래 참조)

모바일의 Claude!

이제부터는 휴대폰에서 앱의 Shell 을 열고 "claude"를 입력하기만 하면 Claude Code 를 실행할 수 있습니다.

중요: 이 앱에는 .claude-user 디렉토리에 자격 증명이 저장되어 있습니다. Git 에서는 무시되지만, 해당 디렉토리를 먼저 삭제하지 않고 이 앱을 다른 사람과 공유하거나 공개해서는 안 됩니다.

방금 한 작업:

"샌드박스"를 만들었습니다. 모든 Replit 앱은 클라우드에서 실행되는 자체 격리 환경입니다. 이를 컨테이너 또는 가상 환경이라고도 합니다.
Replit 앱을 사용하면 코드를 작성하고 실행할 수 있습니다. 일반적으로 자체 에이전트인 Replit Agent 를 사용하여 수행합니다. 앱 왼쪽에서 확인할 수 있습니다.
Claude Code 는 이 템플릿에 이미 구성되어 있어 Shell (터미널)에서 패키지를 시작했습니다.
인증을 통해 Claude 가 .claude-user 디렉토리에 자격 증명을 작성했으며, 이는 Replit 환경 재시작 후에도 유지되는 데 필요합니다.
휴대폰에서 Replit 을 열면 노트북에서 실행 중인 것과 동일한 가상 환경이 로드되었습니다. 환경이 클라우드의 원격 서버에서 실행 중이기 때문입니다.
Replit 은 동일한 환경을 여러 기기에서 실시간으로 표시할 수 있으며, 이를 "멀티플레이어"라고 합니다. 이는 팀의 놀라운 엔지니어링 덕분입니다.
이제 휴대폰과 컴퓨터 모두에서 Claude 를 제어할 수 있습니다. Replit Agent 및 Replit 의 다른 모든 프로젝트에도 동일하게 적용됩니다.

Claude Code 가 설치된 모든 Replit 앱에서 동일한 프로세스를 따를 수 있으며, 이는 명령줄에서 수행할 수 있습니다. 일반적인 방법으로 Skills, 플러그인, MCP 서버 및 Hooks 를 설치할 수도 있습니다.

즐거운 빌드 되세요 ✌️