跳到主要内容

OpenCode

OpenCode 可以通过 OpenAI 兼容配置接入 MuskAI。不同版本的配置文件位置可能不同，但核心字段都是 API Key、Base URL 和模型名。

准备信息​

在官网用户中心 -【API密钥】页面复制：

  • API Key
  • Base URL

模型名使用控制台可用模型。

环境变量方式​

适合临时测试或命令行启动：

export OPENAI_API_KEY="你的 MuskAI API Key"
export OPENAI_BASE_URL="在官网用户中心 -【API密钥】页面复制的 Base URL"
opencode

如果你的 OpenCode 版本使用其他变量名，请以工具当前文档或配置提示为准。关键原则是 Base URL 只填写服务根地址，不要拼接完整接口路径。

配置文件方式​

长期使用建议写入 OpenCode 配置文件，并给 MuskAI 单独命名：

{
  "providers": {
    "muskai": {
      "type": "openai",
      "apiKey": "你的 MuskAI API Key",
      "baseURL": "在官网用户中心 -【API密钥】页面复制的 Base URL"
    }
  },
  "model": "控制台可用模型名"
}

字段名会随 OpenCode 版本变化，实际以当前版本配置格式为准。迁移时只需要保持三项一致：服务类型为 OpenAI 兼容、Key 为本站 Key、Base URL 为用户中心展示地址。

验证​

重新启动 OpenCode 后，发送一个简单任务：

请读取当前目录结构，并说明这个项目的主要技术栈。

如果工具能正常回复并使用你配置的模型，说明接入完成。随后可再配置默认模型、上下文长度或工具权限。

常见问题​

  • 环境变量不生效：确认是在同一个终端会话里启动 OpenCode。
  • 配置文件不生效：检查 OpenCode 实际读取的配置路径和配置优先级。
  • 401/403：检查 API Key、额度和模型权限。
  • 404 或模型不可用：检查模型名，不要把接口完整路径写进 Base URL。