OpenCode

1Run the installer

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai
# bun install -g opencode-ai
# pnpm install -g opencode-ai

brew install anomalyco/tap/opencode

scoop install opencode
# choco install opencode
# npm install -g opencode-ai

sudo pacman -S opencode

2Verify the installation

Run opencode in a project directory; the OpenCode interface means it is installed. Upgrade later with opencode upgrade.

cd your-project
opencode

3Create a Codelux account and API key

1. Go to Codelux Portal and create an account (existing users sign in).
2. Pick a subscription plan or top up in Billing — any balance works for every agent.
3. Open API Keys in the left menu and click Create New Key. Give it a name you will recognise, such as the agent's name.
4. After it is created, copy the API key (starts with sk-) and the API base URL. The key is shown in full only once, so keep it somewhere safe.

4Install CC-Switch

CC-Switch is an open-source (MIT) desktop app that manages API providers for Claude Code, Codex, Gemini CLI, OpenCode and more. It writes the configuration files for you, so you don't have to edit them by hand. Requirements: Windows 10+, macOS 12+, or Linux x86_64/ARM64 with glibc 2.35+ and WebKitGTK 4.1 (e.g. Ubuntu 22.04+, Debian 12+).

brew install --cask cc-switch

sudo apt install ./CC-Switch-v*-Linux-x86_64.deb

5Import Codelux into CC-Switch in one click

1. Keep CC-Switch running (it registers the ccswitch:// link handler on first launch).
2. In Portal, on the success page of the key you just created, find Import to desktop clients. It is only shown on desktop browsers.
3. On the CC-Switch card, set Target app to OpenCode, then click Import.
4. Your browser asks to open CC-Switch — allow it. CC-Switch shows a confirmation dialog with the provider name (Codelux), endpoint and key; confirm to add it.
5. In CC-Switch, switch to OpenCode at the top and make sure the Codelux provider is enabled.

Prefer to add it by hand? In CC-Switch click the orange + → Custom, fill in Provider name (e.g. codelux.io), Website https://codelux.io, your API Key and the Request URL (the Codelux API base URL, no trailing slash), then click Add.

In CC-Switch, OpenCode is a co-existing app: the card button is Add, several providers can stay configured, and you choose between them with /models. Reopen your terminal after importing.

6(Option B) Store the key with /connect

1. Start opencode and run /connect.
2. Scroll to the bottom and choose Other.
3. Enter the provider ID codelux — it must match the key used in opencode.json.
4. Paste your Codelux API key. It is saved to ~/.local/share/opencode/auth.json.

7(Option B) Add the provider to opencode.json

Edit the global config ~/.config/opencode/opencode.json (or opencode.json in a project root to scope it to that project):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codelux": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Codelux",
      "options": {
        "baseURL": "https://codelux.io/v1"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.5": { "name": "GPT-5.5" },
        "kimi-k3": { "name": "Kimi K3" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
        "glm-5.2": { "name": "GLM-5.2" }
      }
    }
  },
  "model": "codelux/claude-sonnet-5"
}

• npm: "@ai-sdk/openai-compatible" uses the Chat Completions API (/v1/chat/completions).
• baseURL is the Codelux API base URL with /v1.
• Each key under models is a model ID from Portal → AI Hub; name is only a display label.
• model sets the default as provider/model.

Without /connect, add "apiKey": "{env:CODELUX_API_KEY}" to options to read the key from an environment variable.

8Pick a model

Run /models in OpenCode; a Codelux group appears — pick a model. You can also list models from the terminal:

opencode models

9Everyday commands

See each request's model, tokens and charge in Portal → Logs.