在 OpenCode 中配置 Sub2API

将 Sub2API 配置为 OpenCode 的 API 后端，使用开源终端 AI 编程助手访问多种模型。

OpenCode 是一款开源的终端 AI 编程助手。通过将 Sub2API 配置为 OpenCode 的 API 后端，你可以在终端中使用 Sub2API 支持的多种模型进行代码生成和补全。

前置条件

• 已安装 OpenCode
• 已获取 Sub2API API Key（详见 创建 API Key）

安装 OpenCode

TODO: 请在后台确认实际配置后填写。

配置方法

OpenCode 支持通过配置文件或环境变量设置 API 后端。

配置文件方式

TODO: 请在后台确认实际配置后填写。（配置文件路径和格式需根据实际确认）

编辑 OpenCode 的配置文件（通常为 ~/.config/opencode/config.toml 或类似路径）：

[provider]
name = "openai"

[provider.openai]
base_url = "https://sub2api.ruilinlu.com"
api_key = "your_sub2api_key"
model = "gpt-4o"

环境变量方式

你也可以通过环境变量快速配置：

export OPENAI_API_KEY="your_sub2api_key"
export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"

验证连接

配置完成后，运行以下命令测试连接：

# 检查版本
opencode --version

# 进入交互模式测试
opencode

故障排查

提示配置文件格式错误

• 确认配置文件语法正确（如 TOML 格式）
• TODO: 请在后台确认实际配置后填写。（确认支持的配置文件格式）

返回 401 错误

• 确认 api_key 已正确设置为 Sub2API API Key
• 参考 401 错误排查

无法连接到 API

• 确认 base_url 已设置为 https://sub2api.ruilinlu.com
• 参考 Base URL 配置