Skip to main content
Now in beta. The Claude Code integration is rolling out to a select group of customers. Want early access? Reach out to support@modelcode.ai and we’ll get you set up.
This page takes you from installing the Morph plugin to a signed-in Claude Code. For what the plugin is and why you’d use it, see Overview. For what you can do once you’re set up, see Use Cases.

Install the plugin

You need Claude Code 2.1.186 or later. Check your version with claude --version, and update with claude update.
1

Add the plugin's marketplace

In Claude Code, run:
2

Install the plugin

If Claude Code asks for a Morph URL, leave it as https://morph.modelcode.ai unless Modelcode gave you another address.
3

Load it

Run /reload-plugins, or restart Claude Code.
To install from a terminal instead, run:
Then start Claude Code, or run /reload-plugins in a session that’s already open.

Sign in

You sign in to the Morph Platform in your browser, and allow Claude Code to use your account. There is no key to copy or paste.
1

Start the sign-in

In Claude Code, run /mcp, pick morph, and choose Authenticate.To sign in from a terminal instead, run:
2

Sign in to Morph

Your browser opens the Morph sign-in. Sign in as you usually do.
3

Allow Claude Code

Morph shows what Claude Code asks for: the account and organization it will act in, and what it can do there. Check that you started this sign-in yourself, then click Allow.Morph consent page asking to allow Claude Code
Claude Code is now connected. It acts as you, with your permissions, in the organization shown on the consent page. Morph emails you each time an app such as Claude Code is connected to your account.

How long a sign-in lasts

Claude Code stays signed in until one of these happens:
  • You sign out, or the sign-in is revoked in Connected Apps.
  • You don’t use it for 30 days.
  • 90 days pass since you signed in.
  • Your Morph account or your organization stops being active.
When a sign-in ends, sign in again the same way.

Sign out

Run /mcp, pick morph, and choose Clear authentication. From a terminal: claude mcp logout plugin:morph:morph. This ends the sign-in in the Morph Platform too.

Manage your sign-ins

Every sign-in shows in Connected Apps. To open it, click your name at the top right of the Morph UI, then choose Connected Apps. Connected Apps page listing Claude Code sign-ins Each row shows the app, when it was connected, and when it was last used. Click Revoke and confirm to end a sign-in. Claude Code can’t start, retry, rebase or merge anything from that moment, and loses access entirely within 10 minutes. Admins also see an Everyone’s apps tab, listing every member’s sign-ins, and can revoke any of them.

Troubleshooting

  • /mcp says morph “needs authentication”, or a call says your sign-in “was revoked or has expired”. You aren’t signed in, or your sign-in ended. Sign in again: /mcp → morph → Authenticate (or Re-authenticate).
  • /mcp says morph failed to connect. Check the Morph URL: /plugin → morph → Configure options. It is https://morph.modelcode.ai unless Modelcode gave you another address. After changing it, run /reload-plugins and sign in again: a sign-in works only for the address it was made on.
  • Morph refused the sign-in. The page says why. Usually your Morph account isn’t active, or your organization’s subscription is paused. Ask an admin of your organization.
  • “Morph can’t confirm your Claude Code sign-in right now”. Morph couldn’t check your sign-in before a start, retry, review re-run, rebase or merge. Try again in a minute.
  • “Project N not found”. The project isn’t in your organization. Ask Claude Code “What are my Morph projects?” to see the ones you can open.
  • “You don’t have the … permission”. Your role in the Morph Platform doesn’t allow that action. Ask an admin of your organization.

Costs

Claude Code’s own usage is not part of your Morph credits. Claude Code runs on your Anthropic plan or API key, and what it spends there is your responsibility. Milestone runs you start from Claude Code run in the Morph Platform and use Morph credits exactly as they do when you start them from the Morph UI. On a billed plan, Claude Code shows you the price and waits for your yes before it starts a run. See Billing and Credits.