Skip to content

// guides

Claude Code on iPad: Magic Keyboard Setup

You can run Claude Code on an iPad today. The fastest path is Cosyra on the App Store — the same iOS app runs natively on iPad Pro, iPad Air, and iPad mini. Pair a Magic Keyboard, paste your Anthropic API key into the Ubuntu container, type claude, and the agent is up. Sign up gets you 1 hour free, no credit card. The two other real options are Anthropic's Claude Code on the Web in Safari, and SSH from Blink Shell into your own always-on machine.

This guide is the iPad-specific companion to our Claude Code on your phone walkthrough. The phone version covers iPhone and Android generically. This one focuses on what changes when the screen gets bigger: Magic Keyboard, Split View, Stage Manager, and the way an iPad plus a real keyboard turns into a serious coding client. For Android-specific form-factor coverage (Termux's npm path on Pixel and Galaxy, foldable layouts, Samsung DeX) see our Claude Code on Android guide, or our Claude Code on Chromebook guide for the local-Crostini-versus-web-client split on ChromeOS, which is its own decision (especially on a managed school Chromebook with the Linux toggle locked). If you want the broader picture of all four AI agents on mobile, start there.

Why is iPad different from iPhone for Claude Code?

iPad is different from iPhone for Claude Code because the form factor unlocks longer prompts, Split View pairing with a browser, and trackpad navigation through diffs. The agent is the same. The interface around the agent changes. On iPhone you write one detailed prompt and skim the diff. On iPad you can keep the terminal open next to the GitHub PR, page through a multi-file refactor with a trackpad, and dictate prompts with the keyboard mic key — closer to a laptop than a phone.

We have an opinion that the Cursor-and-Windsurf crowd would not share: the iPad is a better agent-driven coding device than most people give it credit for. The reason it usually fails as a "coding tablet" is that iPadOS will not run a real local toolchain — no Node, no Python, no Docker. Once you accept that the iPad's job is to be a client to a real Linux box, every "iPad is bad for coding" complaint stops applying. Stage Manager on an M-series iPad with an external display is genuinely good for code review, and the Magic Keyboard's trackpad is the missing piece that pre-2020 iPads were waiting for.

What are the three ways to run Claude Code on iPad?

There are three real ways to run Claude Code on iPad as of 2026-05-18: Cosyra (cloud terminal with Claude Code pre-installed, native iPadOS app), Claude Code on the Web at claude.ai/code in Safari, or SSH from Blink Shell into your own always-on machine. iSH and a-Shell offer local x86 emulation but the speed makes them impractical for agent work. We walk through each option below.

1. Cosyra (cloud terminal, native iPadOS app)

This is what we build. The Cosyra iOS app is a universal binary that runs on iPad with the full iPadOS UI — multitasking, Slide Over, Split View, Stage Manager, external display. You get a persistent Ubuntu 24.04 container with Claude Code, Codex CLI, OpenCode, and Gemini CLI already installed, 30 GB storage, and session hibernation that resumes exactly where you left off. No SSH tunnel to maintain, no laptop that needs to stay awake. The same container is reachable from iPhone, Android, or web, so you can start work on iPad on the couch and pick it up on an iPhone in a parking lot.

2. Claude Code on the Web in Safari

Anthropic's Claude Code on the Web runs tasks on Anthropic-managed VMs. You connect a GitHub repository at claude.ai/code, kick off claude --remote "…", and the VM clones, runs, and pushes a branch. On iPad it renders fine in Safari — the form factor is closer to desktop than iPhone is, so the UI is comfortable. The Claude iOS app is also a universal binary; you can steer sessions from the same iPad.

3. SSH from Blink Shell to your own machine

The classic remote-into-your-laptop path. Blink Shell is a paid iOS terminal ($19.99 annual subscription as of 2026-05-18 per the App Store listing) with Mosh support, a real tmux integration, and Magic Keyboard awareness that's been refined for years. You SSH into a desktop or VPS running Claude Code, Tailscale handles networking, and you run tmux so the session survives app switching.

A note on iSH and a-Shell: both run shell environments on-device, both are free and open source, and both are genuinely cool projects. iSH emulates i386 Alpine Linux (3–5x overhead per the project's own docs), a-Shell ships curated WebAssembly binaries. Neither runs Claude Code today. On iSH, modern Node.js crashes with Illegal instruction per iSH issue #2335 (open since 2024-01-21), which blocks every Node-based AI CLI. On a-Shell, there is no Node global install path at all. For coding-from-iPad in 2026, treat them as terminal-tinkering tools rather than agent platforms. For deeper comparison see Cosyra vs iSH and Termux for iPhone.

How do you set up Claude Code on iPad with Cosyra?

You set up Claude Code on iPad in about three minutes: install Cosyra from the App Store, pair a Magic Keyboard (optional but recommended), paste an Anthropic API key into the container, and type claude. No Node install, no SSH tunnel, no jailbreak. The steps below are exactly what we run on a fresh iPad.

Step 1: Install Cosyra on iPad

Open the App Store on your iPad and search for Cosyra. The app is a universal iOS binary, so the same listing covers iPhone, iPad Pro, iPad Air, and iPad mini. Sign in with Apple, Google, or email and the app provisions a fresh Ubuntu container on first launch. The first launch takes about 15 seconds in our testing.

Step 2: Pair a Magic Keyboard and arrange Split View

Attach the Magic Keyboard or any Bluetooth keyboard with a trackpad. The trackpad is the part that matters: it gives you a cursor for text selection, link tapping, and scrollback that the on-screen interface cannot. Then pull a second app in as Split View — we usually keep Safari on the right with the GitHub PR or repo open, and Cosyra on the left with the terminal.

On M-series iPads (any M1/M2/M3/M4 iPad Pro or iPad Air from 2022 onward) you can switch to Stage Manager from Control Center for floating, resizable windows. Stage Manager also enables a second display over USB-C, which is where the iPad starts to feel like a real workstation.

Step 3: Add your Anthropic API key and run claude

Get an API key from console.anthropic.com. In the Cosyra terminal:

cosyra on iPad, adding the Anthropic API key

$ # Set the key (persists across sessions)

$ echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.bashrc

$ source ~/.bashrc

 

$ claude --version

Claude Code (latest)

Clone a repo and start a session:

cosyra on iPad, starting Claude Code

$ git clone https://github.com/your-org/your-project.git

Cloning into 'your-project'...

$ cd your-project

$ claude

Claude Code (latest)

Type your prompt, or type "/" for commands.

 

> Walk through the changes in the last 5 commits and summarize what's risky.

Claude Code indexes the repo and starts working. Approve or reject diffs inline. On iPad, the larger screen means you can read the full diff without scrolling, which is the single biggest ergonomic win over the phone form factor.

Try it free. 1 hour on signup, no credit card. Extend with a 10-hour, 7-day trial when you want more. App Store / Google Play / Pricing details

Which iPad keyboard shortcuts matter for Claude Code?

The iPad keyboard shortcuts that matter for Claude Code are the iPadOS multitasking ones, not in-app ones. Cosyra is a normal terminal — Ctrl-C, Ctrl-D, Cmd-K (clear) all work as you expect once a hardware keyboard is attached. The shortcuts worth memorizing are the system-level ones:

What does iPad Claude Code look like in practice?

iPad Claude Code in practice looks like Cosyra on the left with the terminal, Safari on the right with the PR or docs, and short voice or typed prompts driving the agent. Below are three workflows we run from iPad regularly.

Couch PR review with Split View

Evening on the couch, a teammate has opened a PR. Open Cosyra, pull the branch, drag Safari in from the dock with the PR open, and ask Claude Code for a structured review:

cosyra on iPad, reviewing a PR

$ git fetch origin

$ git checkout origin/feature/new-auth

$ claude

 

> Review the diff between main and this branch.

Focus on security issues, missing error handling,

and test coverage gaps.

The diff and Claude's notes sit on the left, the PR conversation sits on the right. Post the structured review with gh pr review --comment from the same terminal. No context switch to a laptop.

Multi-agent Stage Manager session on an external display

Plug an M-series iPad Pro into a USB-C display, enable Stage Manager. You get up to four windows: Cosyra running Claude Code on a backend fix, Cosyra in a second tab running Codex on tests, Safari with the staging environment, Notes with the spec. The iPad screen mirrors a smaller Stage Manager group for quick taps. The same container is the source of truth across both surfaces.

Voice-driven prompts during a long task

Long prompts are the place dictation pays off. Press the mic key, speak "add JWT refresh token rotation to the auth middleware, update the tests, and make sure the existing session tests still pass," release. The sentence lands in the prompt buffer and you hit return. We use this on walks (the iPad sits at home, the keyboard mic still works via the iPhone Safari window over universal control on a setup that has one), but mostly we use it at the kitchen counter when typing is slower than thinking.

How do the iPad options compare?

The iPad options compare cleanly when you line them up against what actually matters for an agent client: persistent state, native multitasking, plan dependency, and what happens when the laptop in the closet sleeps. The table below covers the four real iPad paths as of 2026-05-18.

Feature Cosyra (iPad app) Claude.ai/code (Safari) SSH via Blink Shell iSH / a-Shell (local)
Native iPadOS app Yes Safari only Yes (Blink) Yes
Persistent Ubuntu container Yes (30 GB) Session-scoped VM Depends on host Local sandbox
Claude Code pre-installed Yes Yes (managed) You install on host No realistic path
Requires another machine No No Yes (always-on) No
Split View / Stage Manager Yes Yes (Safari) Yes (Blink) Yes
Magic Keyboard / trackpad Full support Full support Full support Full support
Plan dependency Cosyra plan only Claude Pro/Max/Team No plan, host cost None
Setup time ~3 min ~3 min 15–30 min Hours (and still slow)
Cost on iPad $29.99/mo after trial Bundled with plan $19.99/yr + host Free

Choose Cosyra if you want zero host dependency and the same container across iPad, iPhone, and Android. Choose Claude.ai/code if you live in GitHub and already pay for Claude Pro. Choose Blink + SSH if you already have an always-on machine and want full control of the host. Skip iSH and a-Shell for agent work — they are great projects, but the iPad's job is to be a client.

Frequently asked questions

Can you actually run Claude Code on an iPad?

Yes. Claude Code is a Node.js CLI that needs an x86_64 Linux host. iPadOS does not run x86_64 binaries locally and Apple does not let third-party shells install Node globally, so you reach Claude Code through a cloud terminal (Cosyra's iOS app runs natively on iPad), through Claude Code on the Web in Safari, or by SSH from Blink Shell into your own always-on machine.

Do I need a Magic Keyboard, or is the on-screen keyboard enough?

Either works. The on-screen keyboard is fine when you direct Claude Code with short natural-language prompts. A Magic Keyboard with trackpad makes longer prompts, file navigation, and git workflows much faster, and the trackpad is what unlocks multi-window Stage Manager flows.

How does an iPad compare to a laptop for Claude Code work?

Different shapes for different jobs. Laptops win for sustained heavy IDE work, native Xcode or Android Studio, and full window management. The iPad wins for portable agent-driven coding: longer battery, instant resume, Apple Pencil for diff annotation. We use the iPad on the couch and the laptop at the desk; the Cosyra container is the seam between them.

Does Split View or Stage Manager work with Cosyra on iPad?

Yes. Cosyra is a standard iPadOS app, so Split View, Slide Over, and (on M-series iPads) Stage Manager work as expected. Common layout: Cosyra with Claude Code on the left, Safari with the GitHub PR on the right. On an M-series iPad with USB-C display, Stage Manager extends to the external screen.

What about Catnip and similar tools — do those work on iPad?

Tools that wrap GitHub Codespaces with a mobile client (Catnip is one) work on iPad in Safari, since they hand off the heavy lifting to a cloud VM. They are useful if your team already has Codespaces seats and you want a phone-shaped UI around them. For a persistent container that is not tied to a Codespace's idle timeout, a dedicated mobile cloud terminal is a different shape of solution.

Is an iPad Pro overkill for Claude Code?

No. The iPad client is light — terminal rendering and an SSH or WebSocket connection. Any iPad with iPadOS 16+ can run Cosyra. The iPad Pro pays off if you want Stage Manager (M-series only) or external display support. For Claude Code itself, the Anthropic API and your Cosyra container do the work, the iPad is just the screen and keyboard.

tl;dr

Claude Code needs an x86_64 Linux host. On iPad, three real ways to get one as of 2026-05-18: Cosyra (cloud terminal, native iPadOS app, Claude Code pre-installed, persistent container, no other machine required), Anthropic's Claude Code on the Web at claude.ai/code in Safari (GitHub-native, Claude Pro/Max/Team), or SSH from Blink Shell into your own always-on box ($19.99/yr Blink + host cost). Pair a Magic Keyboard, arrange Split View with Safari, and the iPad becomes a serious agent-driven coding client.

App Store / Google Play. Sign up — 1 hour free, no credit card. Extend with a 10-hour, 7-day trial when you want more.

Run Claude Code on your iPad in 3 minutes. Install Cosyra, paste an Anthropic API key, type claude.

See pricing