Run Claude Code + Replit on Your Phone
A tutorial by Matt Palmer. Featured in the OTF curated resource library.
Why Code on Your Phone?
This isn't about replacing your laptop. It's about capturing coding moments that would otherwise be lost. You're on the train with an idea for fixing a bug. You're waiting at a coffee shop and want to prototype a component. You're reviewing a PR from your couch.
Claude Code + Replit on mobile makes these moments productive. Replit provides a full development environment accessible from your phone's browser or native app. Claude Code runs in Replit's terminal, giving you the same agentic capabilities you have on desktop.
The combination is surprisingly powerful: describe what you want in natural language (easy to type on a phone), let Claude Code write the code (hard to type on a phone), and review the results in Replit's mobile preview.
Setting Up the Mobile Environment
Get Claude Code running on Replit in about 10 minutes.
Create a Replit account and install the app
Sign up at replit.com and install the Replit app on your phone (iOS or Android). The app provides a mobile-optimized IDE with terminal access.
Create or open a Repl
Start a new Repl with your preferred template (Node.js, Python, etc.) or open an existing project. Replit provides a full Linux environment in each Repl.
Install Claude Code in the Repl's terminal
Open the Shell tab and install Claude Code. Authenticate with your Anthropic credentials.
npm install -g @anthropic-ai/claude-code claude-code auth
Start coding with Claude Code
Run `claude-code` in the terminal and start describing tasks. The agent reads your Repl's files and can make changes directly. Use Replit's preview pane to see results in real-time.
The Mobile Coding Workflow
Describe, Don't Type Code
The key insight for mobile: let Claude Code do the typing. Your role is describing what you want in plain language. On a phone keyboard, 'add a dark mode toggle to the settings page' is much faster than writing the code yourself.
Use Voice Input
Most phones have excellent voice-to-text. Dictate your prompts instead of typing. 'Fix the login page — the email validation is rejecting valid addresses with plus signs' works perfectly via voice.
Review with Preview
Replit's live preview updates as Claude Code makes changes. Split your screen between the terminal (for Claude Code) and the preview (for visual feedback). This tight loop works surprisingly well on tablet-sized screens.
Commit from Mobile
Replit integrates with GitHub. Commit and push your changes directly from the mobile app. Your mobile coding session becomes a real commit in your project's history.
What Works and What Doesn't
What works well on mobile:
- Bug fixes described in natural language
- Quick component prototypes
- Code review and refactoring with /review
- Documentation generation
- Small feature additions to existing codebases
What's harder on mobile:
- Complex multi-file features (hard to review large diffs on a small screen)
- Debugging with breakpoints (mobile debugging tools are limited)
- Projects requiring lots of manual testing
- Design-intensive work (CSS tweaking is frustrating on a phone)
The sweet spot: mobile coding excels for focused, well-defined tasks where you can describe the change in one prompt and review the result in a preview pane. Save complex, exploratory work for your laptop.
