Skip to content
Coder Docs

Claude Desktop

Let Claude Desktop access your Coder workspaces.

On this page

Claude Desktop is Anthropic's desktop app for Claude. Claude Desktop can list your running Coder workspaces, so you can connect to them from the app.

Note

This integration is implemented by Claude Desktop, not by Coder. Anthropic's documentation doesn't currently describe it, and the behavior can change between Claude Desktop versions.

Prerequisites

  • Claude Desktop installed on your local machine.

  • The Coder CLI installed and on your PATH.

  • The Coder CLI authenticated with your deployment:

    coder login <deployment-url>
  • At least one running workspace.

Set up Claude Desktop

  1. Install the Coder CLI and confirm coder version works in your terminal.

  2. Authenticate the CLI with your deployment:

    coder login <deployment-url>
  3. Restart Claude Desktop. Your running workspaces appear in Claude Desktop.

Show workspace status in Claude Code

The coder-workspace-status plugin shows the status of the workspace Claude Code runs in, right above the prompt. The status covers health, startup scripts, autostop, repositories, and ports opened during the session. Run /coder-workspace-status for a card with links to the dashboard, a browser terminal, and the workspace's apps.

Coder workspace status line and the /coder-workspace-status card in Claude Desktop

The status line above the prompt, and the card that /coder-workspace-status draws.

The plugin works with Claude Code only, version 2.1.287 or later. Install it in the workspace, where Claude Code runs:

claude plugin marketplace add coder/skills
claude plugin install coder-workspace-status@coder-skills

Then start a new session, or run /reload-plugins in the current one.

To install the plugin in every workspace a template creates, run the same two commands from a coder_script that runs after Claude Code is installed. Visit the plugin's README for everything it shows and the data it reads.

Troubleshooting

If your workspaces don't appear in Claude Desktop, check the following:

  1. The Coder CLI is installed and on your PATH. Run coder version.
  2. You're logged in. Run coder login <deployment-url> if needed.
  3. The workspace is running.

Next steps

Claude Desktop connects to workspaces you already have. To explore other ways to use Claude with Coder: