Docs

Using with Claude Desktop

Run Claude Desktop on the account and model you pick in Moxie.

Moxie can run Claude Desktop on whichever account and model you pick in Moxie, the same way it does for Claude Code. Your claude.ai chats and sign-in aren’t touched, and they’re all there again when you switch back.

Before you start#

  • Moxie is running and the proxy is on.
  • Claude Desktop is installed.

Set up#

  1. Open Moxie’s Settings and choose Server.
  2. Turn on Configure Claude Desktop.
  3. Quit Claude Desktop with ⌘Q and open it again. If Desktop is running, Moxie offers to do this for you.

That’s it. Desktop’s model picker now lists the models of your active Moxie account. Send a message and it shows up in Moxie’s Logs tab.

Any setup you already had in Desktop is kept, and turning the switch off brings it back.

A few things to know:

  • Switching accounts or models in Moxie takes effect on Desktop’s next message. No relaunch needed.
  • Switching between a Claude account and another provider changes which models Desktop lists, so relaunch Desktop to refresh its model picker.
  • Changing Moxie’s port needs a relaunch of Desktop too. If you use Random port, the port changes every time the proxy starts, so turn it off if you use Desktop regularly.
  • Claude Code inside Desktop runs on Moxie too.

Set up in Desktop instead#

If you’d rather not let Moxie change Desktop’s settings, you can enter them yourself in Desktop:

  1. In Claude Desktop, choose Help › Troubleshooting › Enable Developer Mode… and confirm. This adds a Developer menu.

  2. Choose Developer › Configure Third-Party Inference….

  3. Click New configuration and name it Moxie.

  4. Fill in the connection settings:

    SettingValue
    Inference providerThe gateway option
    Gateway base URLhttp://localhost:8060
    Credential kindStatic API key
    Gateway API keylocal-proxy
    Gateway auth schemex-api-key

    Use the port shown under Settings › Server › Local port in Moxie if it isn’t 8060.

  5. Turn on Model discovery and click Test model discovery. It should find the models of your active Moxie account. If it finds none, check that Moxie’s proxy is running.

  6. Click Apply Changes, then Relaunch now.

Switch back#

  • If Moxie set it up: turn off Configure Claude Desktop in Moxie, then relaunch Desktop.
  • If you set it up yourself: in Desktop’s Configure Third-Party Inference window, apply a configuration with no inference provider, then relaunch Desktop.

Troubleshooting#

Desktop still opens to claude.ai. Make sure you quit it fully with ⌘Q rather than closing the window. If it still opens to claude.ai, you probably chose claude.ai on Desktop’s sign-in screen earlier, and that choice wins. To change it, quit Desktop, open ~/Library/Application Support/Claude-3p/claude_desktop_config.json in a text editor, set "deploymentMode" to "3p", save, and open Desktop again.

Desktop says it can’t reach your inference provider. Moxie’s proxy isn’t running, or the port changed. Start the proxy in Moxie and check the port under Settings › Server.

The model picker is empty or shows the wrong models. Relaunch Desktop after switching between a Claude account and another provider, or if Moxie’s proxy was off when Desktop started.

Still stuck? Email [email protected] with your Moxie and Claude Desktop versions.