Using with Claude CLI

Once Moxie is set up, every claude session in your terminal runs on the account and model you pick in Moxie. Your Claude sign-in, projects, and settings stay as they are.

Before you start#

• Moxie is running and the proxy is on.
• Claude Code is installed. Moxie’s Home tab shows the version it found, and suggests an update when a newer release adds models.

Set up#

1. Open Moxie’s Settings and choose Server.
2. Turn on Auto-configure Claude Code CLI. It’s on by default, and Moxie asks about it the first time you open it.

That’s it. Start claude in any project and it runs through Moxie.

A few things to know:

• Switching accounts in Moxie takes effect on your next message. Nothing to restart.
• Stopping the proxy or quitting Moxie puts Claude Code back on your own Claude sign-in until you start the proxy again.
• Autofix proxy setup keeps Claude Code connected to Moxie if something resets its settings. It’s on by default; leave it on.
• Random port needs Auto-configure, so Auto-configure stays on while Random port is on.

Presets and model slots#

Claude Code’s model picker has four slots: Fable, Opus, Sonnet, and Haiku. Moxie fills them with models from the active account’s preset, so you can pick a Gemini or OpenAI model right next to the Claude ones.

1. In Moxie’s Home tab, pick the account you want to use.
2. Pick a preset, or edit the slots to choose a model for each one.
3. In Claude Code, run /model. The four slots show the models you chose.

A Claude account shows Claude’s own model names. Other providers show the name of the model you chose for each slot. For everything slots can do, see Using Slots.

Using the Claude Code extension in VS Code? See Using with VSCode.

Set up without Auto-configure#

If you’d rather Moxie didn’t change Claude Code’s settings, turn Auto-configure Claude Code CLI off and add these two lines to your shell profile:

export ANTHROPIC_BASE_URL="http://localhost:8060"
export ANTHROPIC_AUTH_TOKEN="local-proxy"

Use the port shown under Settings › Server › Local port if it isn’t 8060. Presets and model slots need Auto-configure, so with this setup the model picker shows Claude Code’s usual models.

Switch back#

Turn off Auto-configure Claude Code CLI, or stop the proxy. Claude Code goes back to your own Claude sign-in.

Troubleshooting#

Claude Code isn’t using Moxie. Check that the proxy is running (the menu-bar icon shows it) and that Auto-configure Claude Code CLI is on. A session you started before setting up Moxie keeps its old connection, so start a new one.

Messages fail right after switching accounts. The account may need its sign-in renewed. Open Moxie’s Accounts tab: an account that needs attention says so, and Refresh Credentials in its menu renews it.

/model shows the wrong models. The slots follow the account and preset shown in Moxie’s Home tab. If a session you already had open still shows the old ones, start a new session.

Claude Code can’t connect after you changed the port. Sessions started before the change keep the old port. Start a new session.

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