Skip to main content
Claude Desktop is supported on macOS through the Nexus CLI only, with no manual setup. Linux support is coming soon.
Limited support. Claude Desktop can’t stay signed in to claude.ai while it runs through Nexus. It opens a separate local workspace instead:
  • Your claude.ai chats, plugins, and custom skills don’t appear.
  • claude.ai connectors aren’t available. Nexus CLI brings over the connectors and skills saved on your computer, and each connector asks you to sign in again.
Nothing is lost. Run nexus claude-desktop off and reopen Claude Desktop to get your main workspace back. For full support, use Claude Code, Codex, or ChatGPT.

​
Quick start

Install and sign in

You need Node.js 22 or later, git, and bash. On Windows, run the installer from Git Bash. PowerShell breaks the script’s line endings.
Sign in with your browser, or paste a Fireworks API key (fw_...).If the Nexus CLI is already installed and signed in, skip to step 2.

Connect Claude Desktop

Quit, reopen, and pick Auto

Quit and reopen Claude Desktop. Nexus Auto appears along with your Claude models.
To restore your original settings and your claude.ai models, run nexus claude-desktop off, then quit and reopen Claude Desktop.

​
Use Nexus Auto

  • Anthropic and OpenAI model turns need a Provider Key from your admin, or your own saved key. Without either, Nexus Auto serves every turn with Fireworks open models.

​
MCP and tools

  • Native web search is supported. Fireworks runs the search server-side, so no search MCP server is required.
  • Third-party mode hides the in-app connector browser, so you manage connectors with Nexus CLI.
  • on copies your custom skills and plugins once. Run nexus claude-desktop on again to copy ones you add later.

​
Connectors

on imports your existing connectors. Each one asks you to sign in once, the first time you use it after on.
Run nexus claude-desktop mcp sync after you add a connector outside third-party mode.

​
What stays with your claude.ai subscription

Your claude.ai chats, projects, artifacts, memory, and scheduled tasks are hidden while connected, but not deleted. New work is saved only on this computer.

​
Troubleshooting

  • status shows the local gateway is not responding: run nexus claude-desktop on to restart it.
  • Models are missing from the picker: run on once while online, then restart Claude Desktop.
  • The Code tab says the API key was rejected: run on again to refresh the key from your stored credential.