Skip to main content
OpenCode 通过 opencode.json 中的自定义 provider 接入老张API。GPT-6 等 OpenAI 模型用 OpenAI 驱动走 Responses 接口,DeepSeek、Gemini、Qwen 等其他模型用 OpenAI 兼容驱动,两者可以写在同一份配置里。

安装 OpenCode

用 npm 全局安装(需要先安装 Node.js):

配置老张API

1

设置密钥环境变量

使用 bash 时改为 ~/.bashrc。配置文件里用 {env:LAOZHANG_API_KEY} 引用它,密钥不会写进文件。
2

写入 opencode.json

新建或编辑 ~/.config/opencode/opencode.json。只对某个项目生效时,把文件放在项目根目录。
models 中的键必须是完整的模型 ID,name 只用于界面显示。model 的格式是「provider 名/模型 ID」。
3

发一条测试请求

在项目目录运行 opencode 进入交互界面,输入 /models 切换到其他模型;非交互模式用 -m laozhang-compat/deepseek-v4-pro 指定模型。

为什么 GPT-6 要用 @ai-sdk/openai

@ai-sdk/openai-compatible 走 Chat Completions 接口,并会在请求中带 max_tokens。GPT-6 系列不接受这个参数,请求会失败,报错为:
@ai-sdk/openai 走 Responses 接口,没有这个问题,GPT-6 也能直接调用工具。DeepSeek、Gemini、Qwen 等模型接受 max_tokens,放在 @ai-sdk/openai-compatible 下即可。

常见问题

启动后看不到老张API的模型?

检查 opencode.json 是否是合法的 JSON(多余的逗号会导致整份配置无法读取),以及文件位置是否正确。修改配置后重新启动 OpenCode。

报 401?

在运行 OpenCode 的终端执行 test -n "$LAOZHANG_API_KEY" && echo 已设置,确认环境变量已生效。仍然失败时,见 API Key 无效与 Base URL。

还能加哪些模型?

总表中「调用接口」包含 OpenAI 兼容的文本模型都可以加入 laozhang-compat。编程任务建议选能稳定调用工具的模型,见工具接入总览。

相关文档