> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelcode.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Claude Code

> Install the Morph plugin for Claude Code, sign in, and manage your sign-ins

> [!NOTE]
>
> **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](mailto: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](https://docs.modelcode.ai/claude-code/overview.md). For what you can do once you're set up, see [Use Cases](https://docs.modelcode.ai/claude-code/use-cases.md).

## 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:

```text theme={null}
/plugin marketplace add Modelcode-ai/morph-claude-plugin
```

**2. Install the plugin**

```text theme={null}
/plugin install morph@modelcode-morph
```

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:

```bash theme={null}
claude plugin marketplace add Modelcode-ai/morph-claude-plugin
claude plugin install morph@modelcode-morph
```

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:

```bash theme={null}
claude mcp login plugin:morph:morph
```

**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](https://mintcdn.com/modelcodeai/UIO5PsQS2QjKB3fU/claude-code/images/consent-page.png?fit=max\&auto=format\&n=UIO5PsQS2QjKB3fU\&q=85\&s=46ea0120dd34efa8847dc1355d5850d4)

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](https://mintcdn.com/modelcodeai/UIO5PsQS2QjKB3fU/claude-code/images/connected-apps.png?fit=max\&auto=format\&n=UIO5PsQS2QjKB3fU\&q=85\&s=a11e1d10ab027ae75dfd4be8ce964eac)

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](https://docs.modelcode.ai/support/billing-and-credits.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.