OpenCode
最后更新:2026-08-03。第三方工具可能随时更新;如配置失败,请以最新的官方文档为准。
OpenCode 是支持自定义模型 Provider 的终端 Agent。安装前请阅读 OpenCode 安装文档和自定义 Provider 文档。
安装
curl -fsSL https://opencode.ai/install | bash
# Or
npm i -g opencode-ai
配置 Provider
在 ~/.config/opencode/opencode.json 或项目目录的 opencode.json 中加入:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"token-market": {
"npm": "@ai-sdk/openai-compatible",
"name": "Token Market",
"options": {
"baseURL": "https://api.tokensapi.cn/v1",
"apiKey": "{env:TOKEN_MARKET_API_KEY}"
},
"models": {
"<MODEL_ID>": { "name": "<MODEL_ID>" }
}
}
}
}
| 配置位置 | 适用范围 |
|---|---|
~/.config/opencode/opencode.json | 当前用户的多个项目共享;真实 Key 通过环境变量注入。 |
项目目录 opencode.json | 只对当前项目生效,适合团队模板;不要在其中放真实 Key。 |
启动与选模
cd /path/to/your/project
opencode
在输入框使用 /models 选择已配置模型。本页使用 @ai-sdk/openai-compatible 对接 /v1/chat/completions;若选择只支持 Responses API 的模型,需要按官方说明改用 @ai-sdk/openai。若 Provider schema 或字段发生变化,以官方自定义 Provider 文档为准。
