OpenCode

​

Quick start

Install and sign in

curl -fsSL https://nexus.fireworks.ai/install.sh | bash

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.

nexus login

Sign in with your browser, or paste a Fireworks API key (fw_...).Already set up? Skip to step 2.

Connect OpenCode

nexus opencode
nexus opencode status

Restart and pick a model

Restart OpenCode and pick a model with /models. The default is auto, stored as fireworks-ai/auto. To change the default, run nexus opencode --model glm-latest.Models that OpenCode already lists from models.dev keep their full ID, such as fireworks-ai/accounts/fireworks/routers/glm-latest, so nothing shows twice. Nexus CLI adds the rest, such as auto, under short IDs.

nexus opencode status shows the provider, where the key comes from, and the configured model.

​

Use Nexus Auto

• Anthropic and OpenAI model turns: save a key with nexus auto --anthropic-api-key or --openai-api-key (each prompts for the key), then run nexus opencode again. Nexus CLI adds the saved key to the provider headers in opencode.json. Or connect a Provider Key, which needs nothing saved locally.
• Environment keys: Nexus CLI never sends ANTHROPIC_API_KEY or OPENAI_API_KEY from your environment.
• Manual setup: send x-anthropic-api-key and x-openai-api-key headers yourself. See Manual setup (advanced).

​

MCP and tools

// ~/.config/opencode/opencode.json
{
  "mcp": {
    "docs": {
      "type": "local",
      "command": ["npx", "-y", "your-mcp-server"],
      "enabled": true
    }
  }
}

​

Microsoft Foundry

​

Troubleshooting

​

Manual setup (advanced)

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fireworks-ai": {
      "options": { "apiKey": "{env:FIREWORKS_API_KEY}" },
      "models": {
        "glm-latest": { "name": "GLM (Latest)" },
        "auto": { "name": "Nexus Auto" }
      }
    }
  },
  "model": "fireworks-ai/glm-latest"
}

​

What the Nexus CLI writes

{
  "provider": {
    "fireworks-ai": {
      "options": {
        "apiKey": "fw_...",
        "headers": { "x-anthropic-api-key": "sk-ant-..." }
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 1048575, "output": 131072 },
          "modalities": { "input": ["text", "image"] }
        }
      }
    }
  },
  "model": "fireworks-ai/auto"
}