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

> ## Agent Instructions
> For agents: install the OpenWork desktop app with `brew install --cask openwork` (macOS) or from https://openworklabs.com/download. Do not run `npx openwork`; the npm package named `openwork` is a different project.
> Connect an agent to OpenWork with the MCP Gateway: `claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent`. Teams sign up at https://app.openworklabs.com?mode=sign-up.
> Step-by-step agent guide: https://openworklabs.com/docs/start-here/use-openwork-from-an-ai-agent.md
> Connect Slack (any organization admin): https://openworklabs.com/docs/slack/connect-slack.md. OpenWork in Slack (@openwork bot) is private alpha for approved organizations. Setup guide: https://openworklabs.com/docs/slack/overview.md. Agent skill: https://openworklabs.com/.well-known/agent-skills/set-up-openwork-slack/SKILL.md.

# Sign in with your own Anthropic subscription

> Use your paid Claude plan in the OpenWork desktop app through the Claude Code signed in on your own computer. Local only: it does not work with OpenWork Cloud.

> [!WARNING]
>
> **Local only. This does not work with OpenWork Cloud (Den).** Your Claude plan is used through the Claude Code app on your own computer, so it only works in the desktop app, for you, on that computer. An admin cannot add it for a team, and it does not run in OpenWork in the browser, Workbot or Slack. See [What "local only" means](#what-local-only-means).

If you pay for Claude, you can use that plan to run OpenWork on your own computer, with no API key.

OpenWork does not sign you in to Anthropic itself. You install [Claude Code](https://code.claude.com/docs/en/setup), Anthropic's own app, and sign in to it once. OpenWork then runs your tasks through that Claude Code, with the login it already has.

> [!NOTE]
>
> **Rolling out.** This option is being turned on gradually. If step 3 below only offers an API key, it is not on for you yet. Use [an Anthropic API key](https://openworklabs.com/docs/start-here/connect-your-stack/add-anthropic-api-key.md) in the meantime.

## What "local only" means

It works here:

* The OpenWork desktop app, in a workspace on your own computer, with Claude Code installed and signed in on that same computer.
* You can be signed in to OpenWork Cloud at the same time. Claude Code stays a personal connection under **On this device**.

It does not work here:

* **For a team.** Admins cannot add a Claude subscription in **AI Gateway** or share yours with anyone. Each person connects their own, on their own computer.
* **In the cloud.** OpenWork in the browser, Workbot and OpenWork in Slack run on servers, where your Claude Code login does not exist.
* **On another computer.** A workspace that runs somewhere else would need Claude Code installed and signed in there, not on yours.

It is also not counted by your organization. Usage does not appear in AI Gateway usage and does not count toward limits an admin set. It counts against your own Claude plan.

If your organization chose **Only models you provide** under **AI Gateway**, **Connect a provider** is locked and you cannot use your own Claude plan in OpenWork. Ask your admin, or use the models your organization shares with you.

To give a whole team Claude models, an admin adds Anthropic with an API key instead. See [Adding a managed LLM provider](https://openworklabs.com/docs/cloud/share-with-your-team/managed-llm-provider.md).

## Before you start

* A paid Claude plan that includes Claude Code, such as Pro or Max.
* Claude Code version 2.1.248 or later, installed on the computer where you use OpenWork. Follow [Anthropic's setup guide](https://code.claude.com/docs/en/setup). To check your version, run `claude --version` in a terminal.
* The latest OpenWork desktop app.

## Sign in to Claude Code

Do this once, in a terminal on the same computer:

```bash theme={null}
claude auth login
```

A browser tab opens. Sign in with the account that holds your Claude plan, then return to the terminal.

OpenWork never sees this sign-in. It does not ask for your Claude email, password or any token.

## Connect it in OpenWork

1. Open **Settings › AI Providers** and click **Connect a provider**.

![AI Providers in OpenWork settings, with the Connect a provider button](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-ai-providers.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=1c8eec1789e3ac3a48ab59d7685fd224)

2. Search for **Anthropic** and choose it. Its line reads "Sign in with Claude Code or paste an API key".

![Connect a provider, with Anthropic offering Claude Code or an API key](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-anthropic-entry.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=dbee1a9f621479c26124ed592b582417)

3. You see "Choose how you'd like to connect." Choose **Claude Code**.

![The two ways to connect Anthropic: Claude Code and API key](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-choose-how.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=6ac170d72b83bc0ceb72a2d45b6c769a)

4. The next step shows the sign-in command again, in case you have not run it yet. Click **Connect**.

![The Claude Code step with the claude auth login command and the Connect button](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-sign-in-step.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=c8a9cd7f60bf44cd2132796e989b400e)

5. The button reads "Checking Claude Code…" while OpenWork checks that Claude Code is installed and signed in. This takes a few seconds.
6. When the check passes, the dialog closes and you see "Claude Code connected". **Claude Code** is now listed under **On this device** as **Ready to use**.

![AI Providers with Claude Code listed as Ready to use](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-connected.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=c005ecd59e9e590a810ca2c7177472d2)

## Pick a Claude model

1. In a chat, click the model name under the message box.
2. Choose a model under **Claude Code**. The list comes from Claude Code and depends on your plan.

![The model list in a chat, showing the models from Claude Code](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-model-list.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=6b1cb1e7ce066da477a4b43e24b4f237)

## If the check does not pass

The dialog stays open and says why. Fix it, then click **Check again**.

![The Claude Code step showing that Claude Code is not logged in, with a Check again button](https://mintcdn.com/differentai/kso_df0rjQ64k1CJ/images/claude-code-not-signed-in.png?fit=max\&auto=format\&n=kso_df0rjQ64k1CJ\&q=85\&s=ef98454d0ad2fda8bc08b26acd89626a)

* **"Claude Code is not logged in."** Run `claude auth login` in a terminal, finish the sign-in in your browser, then click **Check again**.
* **"Claude Code is not installed."** Click **Install Claude Code**, follow Anthropic's guide, run `claude auth login`, then click **Check again**.
* **"Couldn't confirm that Claude Code is ready."** Claude Code did not answer in time. Make sure it opens in a terminal on this computer, then click **Check again**.

## What the status means later

The **Claude Code** row under **Settings › AI Providers › On this device** shows one of these:

* **Ready to use.** OpenWork checked Claude Code and it is signed in.
* **Not checked yet.** OpenWork has restarted and has not checked Claude Code again. You can keep using it. If something is wrong, the row changes to **Needs your sign-in**.
* **Needs your sign-in.** Claude Code got signed out or stopped working. Run `claude auth login` in a terminal, then click **Sign in again** and **Check again**.

## Disconnect

Click **Disconnect** on the **Claude Code** row. This removes the connection from OpenWork only. Claude Code itself stays installed and signed in on your computer.

## Common issues

* **Anthropic only offers an API key.** The option is not turned on for you yet, or your OpenWork is out of date. Update the desktop app, or use [an Anthropic API key](https://openworklabs.com/docs/start-here/connect-your-stack/add-anthropic-api-key.md).
* **Connect a provider is locked.** Your organization only allows the models it provides. Your own Claude plan cannot be used in OpenWork there.
* **A chat says Claude Code is too old.** Run `claude update` in a terminal, then send the message again.
* **A teammate cannot see your Claude models.** That is expected. This connection is yours alone and stays on your computer.
* **You want Claude for your whole team.** Use an API key through AI Gateway: [Adding a managed LLM provider](https://openworklabs.com/docs/cloud/share-with-your-team/managed-llm-provider.md).


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