Using with VSCode

With the Moxie extension, the model picker in the Claude Code extension shows the models from your Moxie presets, and keeps up as you switch accounts or presets in Moxie.

Caution: the Moxie extension is required for presets and model slots to work in VS Code. Without it, open chats keep showing old model names until you start a new chat.

Before you start#

• Moxie is running and the proxy is on.
• Auto-configure Claude Code CLI is on, under Settings › Server in Moxie. It sets up the Claude Code extension as well as the terminal.
• The Claude Code extension is installed in VS Code, Cursor, or Windsurf.

Install the extension#

Moxie installs it for you:

• When you first set up Moxie. Leave the VS Code extension switch on. Moxie adds the extension to VS Code, Cursor, and Windsurf on your Mac, including each of your VS Code profiles.
• Any time later. Open Settings › Server in Moxie and click Update now next to VS Code extension. The same row shows which editors have it.

Then reload any editor window that’s already open: open the Command Palette and run Developer: Reload Window. New windows pick it up on their own.

Moxie keeps the extension up to date in the background. Update now does the same right away.

Install by hand#

If Moxie can’t find your editor, you can add the extension yourself:

1. Download https://artifacts.birju.dev/moxie/vscode/moxie-<version>.vsix, with <version> replaced by your Moxie version. You’ll find it under Settings › Updates in Moxie.
2. In your editor, open the Extensions view, click the ··· menu at its top, and choose Install from VSIX….
3. Pick the file you downloaded.

Moxie can’t update a copy it can’t find, so repeat this after each Moxie update.

Use presets and model slots#

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 your editor, open the model picker in any Claude Code chat. The four slots show the models you chose.

The picker updates within a few seconds of each change, in every open chat. 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.

Good to know#

• After your first switch, your editor’s settings include a USE_LOCAL_OAUTH entry. The Moxie extension manages it, so leave it in place.
• Remote windows, such as Remote SSH, containers, and WSL, aren’t supported. Use a local window.
• Moxie and your editor need to run on the same Mac.

Troubleshooting#

The picker still shows old models. Reload the window once after installing (Developer: Reload Window). Then check that Settings › Server › VS Code extension in Moxie lists your editor with a version, and that Auto-configure Claude Code CLI is on.

Your editor isn’t listed in Moxie. Moxie looks for editors in your Applications folder. Move the app there, or install the extension by hand.

There’s no VS Code extension row in Settings. Moxie didn’t find VS Code, Cursor, or Windsurf in your Applications folder.

One of your VS Code profiles doesn’t have the extension. Moxie adds it to new profiles within an hour, or right away with Update now.

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