OpenCode

工具用途

OpenCode 是一款开源的终端 AI 编程助手，支持代码生成、补全和多模型切换。通过配置零派智能API，你可以在 OpenCode 中使用平台支持的各种模型。

API Provider 配置位置

OpenCode 通过配置文件进行设置。配置文件位于项目根目录或用户主目录：

• 项目级：./opencode.json
• 用户级：~/.opencode/opencode.json

Base URL 填什么

在配置文件中的 provider 设置部分，将 base_url 设置为：

{
  "provider": {
    "base_url": "https://your-domain.com/v1",
    "api_key": "sk-your-api-key",
    "model": "gpt-4o"
  }
}

将 your-domain.com 替换为你的 零派智能API 实际域名。确保 URL 末尾包含 /v1。

也可以通过环境变量设置：

export OPENCODE_BASE_URL="https://your-domain.com/v1"

API Key 填什么

在配置文件的 api_key 字段中填写你在 零派智能API 平台创建的 API Key：

sk-xxxxxxxx

或通过环境变量设置：

export OPENCODE_API_KEY="sk-your-api-key"

Model 填什么

在配置文件的 model 字段中填写模型名称，例如：

• gpt-4o
• gpt-4o-mini
• claude-3-5-sonnet-20241022

或通过环境变量设置：

export OPENCODE_MODEL="gpt-4o"

完整配置示例

{
  "provider": {
    "name": "openai",
    "base_url": "https://your-domain.com/v1",
    "api_key": "sk-your-api-key",
    "model": "gpt-4o"
  }
}

保存后如何验证

1. 保存配置文件
2. 在终端运行 opencode 启动 OpenCode
3. 输入一条测试消息，如「Hello」
4. 如果收到回复，说明配置成功

常见问题

配置文件不生效？

确认配置文件路径正确。项目级配置会覆盖用户级配置。检查 JSON 格式是否正确，无多余逗号或缺少引号。

提示 "Connection refused" 怎么办？

检查 Base URL 是否正确，确保域名可访问。可以尝试用 curl 测试连接：curl https://your-domain.com/v1/models -H "Authorization: Bearer $API_KEY"。

如何切换不同模型？

修改配置文件中的 model 字段，或设置环境变量 OPENCODE_MODEL，然后重启 OpenCode 即可。