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
-
Install the Coder CLI and confirm
coder versionworks in your terminal. -
Authenticate the CLI with your deployment:
coder login <deployment-url> -
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.

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-skillsThen 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:
- The Coder CLI is installed and on your
PATH. Runcoder version. - You're logged in.
Run
coder login <deployment-url>if needed. - The workspace is running.
Next steps
Claude Desktop connects to workspaces you already have. To explore other ways to use Claude with Coder:
- Agent Relay for Claude Code: run Claude Code's cloud sessions inside self-hosted Coder workspaces. Unlike the Claude Desktop integration, Agent Relay orchestrates the workspaces itself. It creates a workspace from a template for each session and deletes it when the session ends, instead of using your existing workspaces. Visit the Agent Relay overview for how it works.
- Claude Code with AI Gateway: route Claude Code running in a workspace through AI Gateway.
- Sign in to Claude Code with a Claude subscription: authenticate Claude Code in a workspace with your Claude subscription.