跳转到主要内容
在 OpenCode 里使用老张API:在 opencode.json 中添加自定义 provider,接口地址设为 https://api.laozhang.ai/v1,密钥用老张API密钥。

安装 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 走 Responses 接口,GPT-6 能直接调用工具。gpt-6.1-sol 的 max 推理强度和联网搜索(web_search)也只能在 Responses 中使用。 @ai-sdk/openai-compatible 走 Chat Completions 接口,并会在请求中带 max_tokens。2026 年 11 月 4 日之前,GPT-6 系列不接受这个参数,请求会失败,报错为:
老张API现在已兼容这个参数和 Chat Completions 中的工具调用,GPT-6 放在 laozhang-compat 下也能使用。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。编程任务建议选能稳定调用工具的模型,见工具接入总览。

相关文档