OpenCode

OpenCode 是开源的终端 AI 编程工具，可以同时配置 OpenAI 协议和 Anthropic 协议的服务商。

第 1 步：安装

npm install -g opencode-ai

第 2 步：配置

编辑配置文件（不存在就新建）：

• 全局：~/.config/opencode/opencode.json
• 单个项目：项目根目录下的 opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "moniker": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Moniker（OpenAI 协议）",
      "options": {
        "baseURL": "https://aimoniker.top/v1",
        "apiKey": "{env:MONIKER_API_KEY}"
      },
      "models": {
        "gpt-5.6": { "name": "GPT-5.6" },
        "glm-5.3": { "name": "GLM-5.3" },
        "kimi-k3": { "name": "Kimi K3" }
      }
    },
    "moniker-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "Moniker（Claude）",
      "options": {
        "baseURL": "https://aimoniker.top/v1",
        "apiKey": "{env:MONIKER_CLAUDE_KEY}"
      },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-opus-4-8": { "name": "Claude Opus 4.8" }
      }
    }
  }
}

关于 baseURL

OpenCode 底层用的是 AI SDK，它的 Anthropic 适配器要求地址带 /v1，这一点和 Claude Code 不同。

设置环境变量（建议分别使用对应分组的密钥）：

macOS / Linux

# 写入 ~/.bashrc 或 ~/.zshrc 后重新打开终端
export MONIKER_API_KEY="sk-xxxx"      # 例如国产模型或 codex 分组的密钥
export MONIKER_CLAUDE_KEY="sk-yyyy"   # Claude 分组的密钥（不限客户端的分组）

Windows PowerShell

[Environment]::SetEnvironmentVariable("MONIKER_API_KEY", "sk-xxxx", "User")
[Environment]::SetEnvironmentVariable("MONIKER_CLAUDE_KEY", "sk-yyyy", "User")
# 设置后重新打开终端

第 3 步：使用

cd your-project
opencode

在 OpenCode 中输入 /models，选择 Moniker 下的模型。

常见问题

现象	原因 / 解决
列表里看不到 Moniker	配置文件 JSON 格式有误，或路径不对
401	环境变量没生效，重新打开终端后再试
Claude 模型报错	使用了仅限 Claude Code 的分组，换成 claude-pro、claude-ultra 等