How to use Claude Code, Cursor or Codex on a Base44 app
Three ways to bring Claude Code, Cursor or Codex to Base44: GitHub sync, the app's cloud sandbox via the CLI, or the Base44 MCP server. Plans, setup and trade-offs.
8 min read
You can work on a Base44 app with Claude Code, Cursor, Codex or any other coding agent in three ways: sync the app to GitHub and edit a local clone, point the agent at the app’s cloud sandbox with the Base44 CLI, or connect over the Base44 MCP server. All three need the Builder plan or higher. Base44 ties message credits to its own AI chat, so edits your own agent makes shouldn’t draw on them.
This fits the lightest level of the Base44 migration guide: you keep Base44 and gain a real development setup.
Option 1: send the app to your agent from the editor
The quickest route, per Base44’s bring-your-own-agent docs:
- Open the app in Base44’s editor.
- Click More actions (the three dots next to Publish) and choose Send to Coding Agent.
- Pick a local CLI agent or a web chat.
- Paste the generated prompt into your agent.
The prompt contains what the agent needs to connect to the app’s sandbox. It isn’t offered for mobile apps or apps with unmanaged source code.
Option 2: the cloud sandbox via the CLI
The sandbox is the same cloud environment Base44’s editor uses. Your agent reads, searches, edits and runs commands there, with no local checkout.
npm install -g base44@latest # Node.js 20.19.0+
base44 login # grants the sandbox:write permission
export BASE44_APP_ID=<your-app-id> # from app.base44.com/apps/<app-id>/editor
base44 sandbox ls # confirm the connection
Then give your agent the app’s README, which Base44 publishes for exactly this, at https://app.base44.com/api/sandbox/<app-id>/local-agent/readme.md. It explains how to work in the sandbox with commands like base44 sandbox read, grep, edit, write, run and checkpoint.
Without the Builder plan, these commands fail with PREMIUM_REQUIRED.
Option 3: GitHub sync and a local clone
If you want commits, branches and pull requests, connect GitHub (see the GitHub integration guide), clone the repo and work in it like any project:
git clone git@github.com:you/your-app.git && cd your-app
npm install && base44 link && base44 dev
claude # or open the folder in Cursor, or run codex
Merge into main and your changes sync back to Base44. Click Publish to make them live. The local development guide explains what base44 dev runs on your machine.
Option 4: the Base44 MCP server
For assistants that connect over MCP, including web chats that can’t run a CLI, add Base44’s MCP server:
{ "mcpServers": { "base44": { "url": "https://app.base44.com/mcp" } } }
It exposes your Base44 account, so the assistant can create and update projects for you. It also needs the Builder plan. There’s a separate Docs MCP server that lets an assistant search Base44’s documentation. The MCP server guide covers both, plus App MCP, which connects assistants to an app you’ve published.
Which to use
| You want | Use |
|---|---|
| Version control and pull requests | GitHub sync + local clone |
| The agent editing the live app environment, no setup | Cloud sandbox via CLI |
| To build and manage apps from Claude or ChatGPT chat | Base44 MCP server |
| Your agent to answer questions about Base44 accurately | Docs MCP server or Base44 skills |
Credits and costs
Base44’s docs describe message credits as spent by prompts in its AI chat, so changes your own agent makes shouldn’t use them. You pay your agent’s provider instead. Check your credit usage page after your first session to confirm. Integration credits are separate: they’re spent whenever the app calls Base44’s built-in services, such as sending email or calling an LLM, no matter who wrote the code. See the credits guide.
What to do next
- Try Send to Coding Agent on a small change first.
- If you like working locally, connect GitHub and install the Base44 skills.
- Weighing Base44 against a pure coding-agent workflow? Read Base44 vs Claude Code.
Frequently asked questions
- Can I use Claude Code with Base44?
- Yes. On the Builder plan, you can connect Claude Code to your app's cloud sandbox with the Base44 CLI, work on a GitHub-synced clone locally, or connect over the Base44 MCP server. Base44's editor also has a Send to Coding Agent option that writes the connection prompt for you.
- Does using Claude Code save Base44 credits?
- Base44's docs tie message credits to prompts in its own AI chat, so edits your own agent makes shouldn't use them. You pay for your agent's own usage instead. Integration credits still apply whenever the app itself calls Base44's built-in services.
- Which is better for Base44: GitHub sync or the sandbox?
- GitHub sync if you want version control, pull requests and a local environment. The sandbox if you want your agent to edit the app in place with no local setup, in the same environment Base44's editor uses.
- Do I need the Builder plan to use an AI coding agent with Base44?
- For the sandbox and GitHub sync, yes. Without it, sandbox commands fail with a PREMIUM_REQUIRED error. The Base44 MCP server also requires the Builder plan or higher.
Read next
Keep going
-
Base44 GitHub integration: how two-way sync works
How to connect a Base44 app to GitHub, how two-way sync behaves, the rules that catch people out, and how Base44's GitHub import works for existing repositories.
-
Running a Base44 app locally with the Base44 CLI
Run a Base44 app on your own machine: clone from GitHub or eject with the CLI, link it, and use base44 dev. What runs locally, what's forwarded, and the remote-mode trap.
-
The Base44 MCP server, App MCP and connecting AI assistants
Base44 has three MCP features: an MCP server to build apps from Claude or ChatGPT, App MCP to let assistants use a published app, and custom MCP connections.
-
Base44 vs Claude Code (and Cursor): builder or coding agent?
Base44 vs Claude Code and Cursor: what each is for, who each suits, costs, code ownership and SEO, and how to use both together on the same Base44 app.