1. opencode 环境搭建前先把 node.js 和 npm 这两件事理清楚opencode 是一个跑在终端里的 AI 编程助手能读你本地的代码、按自然语言改文件、执行命令适合习惯命令行工作流的开发者。它本身不绑定某一家模型服务只要你给出兼容的 BASE URL 和 API KEY就能把请求打到任意 OpenAI/Anthropic 兼容通道上。这篇就围绕「opencode 环境搭建 自定义 BASE URL 配置」这条链路把 node.js、npm、API KEY 管理、BASE URL 改写一次讲透最后确认请求确实指向 TaoToken 的统一 Key 通道。很多人卡在第一步不是不会敲命令而是环境本身没理顺。opencode 的安装方式有两种官方脚本和 npm 全局包。官方脚本会自己处理运行时依赖npm 方式则要求你本机已经有可用的 node.js 和 npm。如果你打算用 npm 装那 node.js 版本就是硬门槛——太老的版本会在安装阶段直接报 engine 不匹配或者装上了运行时报SyntaxError、Cannot find module这类错。我建议先确认版本再决定用哪种安装方式。打开终端执行node -v npm -v正常应该看到类似v22.x.x和10.x.x的输出。opencode 官方推荐 node.js 22 或更早的稳定版本node 20 LTS 也完全够用。如果你看到的是v16甚至更低别急着装 opencode先把 node 升上去否则后面 npm 安装大概率失败。升级 node.js 的方式看你系统。macOS/Linux 用户如果装了 nvm直接nvm install 22 nvm use 22Windows 用户去 nodejs.org 下载 LTS 安装包覆盖安装即可安装时勾选「Add to PATH」装完重开一个终端再验证版本。这里有个小坑Windows 上如果之前用管理员权限装过 node普通终端里node -v可能还是旧版本因为 PATH 里存在两份。用where nodeWindows或which nodemacOS/Linux看一下实际调用的是哪一个路径不对就手动调整环境变量顺序。npm 一般随 node 一起装好但如果你遇到 npm 版本过旧导致npm install -g权限报错可以顺手升一下npm install -g npmlatestmacOS/Linux 下如果全局安装报EACCES权限错误不要用sudo npm install -g硬来那会把包装到 root 目录后续升级很麻烦。正确做法是配置 npm 的全局目录到用户空间mkdir -p ~/.npm-global npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATH把最后一行写进~/.bashrc或~/.zshrc重开终端生效。这一步做完后面npm install -g opencode-ai就不会再要权限了。环境确认无误后安装 opencode 本身。官方脚本方式curl -fsSL https://opencode.ai/install | bashnpm 方式npm install -g opencode-ainpm 安装视网速可能要几分钟装完执行opencode --version能看到版本号就说明二进制已经就位。如果提示command not found八成是 npm 全局 bin 目录不在 PATH 里回到上面那步检查npm config get prefix的输出把对应的bin目录加进 PATH。到这里node.js、npm、opencode 三件套就齐了。接下来才是重点怎么把 opencode 的请求指向 TaoToken 的统一 Key 通道而不是默认的官方端点。这一步决定了你后面能不能用上自己管理的 API KEY也决定了多模型切换时配置是否干净。2. TaoToken 前置准备拿到统一 Key 和 BASE URL 该填什么在改 opencode 配置之前先把 TaoToken 这边的信息准备好否则配置文件里baseURL和apiKey两个字段你不知道填什么。TaoToken 的定位是一个统一的模型 API 通道你用一把 Key 就能访问它支持的多个模型省去在每家平台分别注册、分别管 Key 的麻烦。对 opencode 这种需要频繁切换模型的工具来说统一 Key 的好处很直接配置文件里只维护一份凭证换模型只改 model id不用动鉴权部分。第一步是拿到 API KEY。访问 TaoToken 控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite登录后创建一个新的 Key复制出来先存到安全的地方。这个 Key 就是后面配置文件里apiKey字段的值。注意不要把它提交到 Git 仓库也不要在截图里暴露。如果你习惯用环境变量管理凭证可以把它写进 shell 配置export TAOTOKEN_API_KEYsk-你的key然后在 opencode 配置里用变量引用具体是否支持变量插值取决于版本稳妥起见先直接填值确认跑通后再考虑抽离。第二步是确认 BASE URL。TaoToken 的 API 入口是https://taotoken.net/api注意这里不要加 UTM 参数API 请求地址保持干净。opencode 走的是 OpenAI/Anthropic 兼容协议所以baseURL通常要带上/v1后缀也就是https://taotoken.net/api/v1。这一点很关键很多 401 或 404 报错就是因为 baseURL 少了/v1或者多写了一层路径。你可以在配置前先用 curl 探一下通道是否可达curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY返回200说明 Key 和地址都对返回401是 Key 无效或没带上返回404多半是路径写错了。这个探测命令建议在改 opencode 配置前先跑一遍把变量隔离出来后面排障会省很多事。第三步是确定你要用的 Model ID。opencode 的配置里每个模型有一个 key比如glm-5.1这个 key 要和 TaoToken 通道里实际可用的模型名对应。你可以通过模型对话页面先确认目标模型能正常响应https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite在页面上选一个模型发一条测试消息确认返回正常。记下这个模型的标识名后面写进 opencode 配置的models字段。如果你打算长期用 opencode 做编码和 Agent 任务可以考虑 Coding Plan它在高频调用场景下更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite前置准备就这三样API KEY、BASE URL带/v1、Model ID。三样齐了接下来就是往 opencode 的配置文件里填。这里要提醒一句TaoToken 是统一的 API 通道不是让你绕过什么而是把多家模型的鉴权和计费收敛到一处配置上更清爽。你按正常 API 使用方式接入即可。3. 可复制配置opencode 的 config.json 怎么写才不报错opencode 的配置文件位置按系统区分。Windows 一般在C:\Users\你的用户名\.config\opencode\config.jsonmacOS/Linux 在~/.config/opencode/config.json如果目录不存在手动建一下。这个文件是 JSON 格式opencode 启动时会读取它来决定 provider、baseURL、apiKey 和可用模型列表。下面是一份可以直接复制修改的完整配置{ $schema: https://opencode.ai/config.json, provider: { default: { npm: ai-sdk/anthropic, options: { baseURL: https://taotoken.net/api/v1, apiKey: sk-换成你自己的API KEY }, models: { glm-5.1: { name: glm-5.1 API, limit: { context: 200000, output: 64000 } } } } } }逐字段说明一下避免你改错地方。$schema指向 opencode 的配置 schema保留即可编辑器能据此做补全和校验。provider.default是默认 provider 的名字你可以改成别的但后面/models里选模型时要对应。npm字段指定用哪个 SDK 适配层ai-sdk/anthropic表示走 Anthropic 兼容协议如果你的模型是 OpenAI 兼容的这里可能要换成ai-sdk/openai具体看模型通道的协议类型。options.baseURL就是本篇的核心——自定义 BASE URL。填https://taotoken.net/api/v1注意结尾的/v1。options.apiKey填你在 TaoToken 控制台创建的那把 Key。这两个字段决定了 opencode 把请求发到哪里、用什么身份鉴权。models下面每个条目是一个可用模型。key这里是glm-5.1是你在 opencode 里引用模型时用的标识name是显示名limit.context和limit.output是上下文窗口和最大输出 token 数。这两个 limit 值要和你实际用的模型能力匹配填大了可能被服务端拒绝填小了会浪费上下文。如果你不确定先按模型文档给的数值填。如果你要配多个模型在models里并列加条目即可models: { glm-5.1: { name: glm-5.1 API, limit: { context: 200000, output: 64000 } }, 另一个模型id: { name: 另一个模型, limit: { context: 128000, output: 32000 } } }改完配置后JSON 语法一定要校验。最常见的错误是多了或少了逗号、引号不配对。可以用 node 自带的检查node -e JSON.parse(require(fs).readFileSync(process.env.HOME /.config/opencode/config.json,utf8)); console.log(JSON OK)Windows 下把路径换成实际路径。看到JSON OK再继续否则 opencode 启动时会直接报解析错误连模型列表都加载不出来。还有一个容易忽略的点如果你之前配过别的 provider比如官方端点记得把旧的baseURL和apiKey替换掉而不是新增一个 provider 却忘了把default指过去。opencode 用的是provider.default作为默认如果你新增了 provider 但 default 还指向旧的请求还是会打到旧地址。改完确认default这一层里的baseURL就是 TaoToken 的地址。配置写好后先别急着开 opencode用上一节的 curl 命令再确认一次通道可达。配置文件和网络通道两边都对了再启动才不容易混淆问题来源。4. 验证请求启动 opencode 并用 /models 确认指向 TaoToken配置就绪后打开一个新的命令行终端重要要新开让环境变量和 PATH 生效输入opencode如果安装和配置都正常你会看到 opencode 的 TUI 界面启动。第一次启动它可能会做一些初始化稍等几秒。进入界面后输入斜杠命令/models这时应该能看到你在config.json的models里配置的模型比如glm-5.1并且它归属于default这个 provider。选中它回车opencode 就会用这个模型作为当前会话的模型。选中模型后发一条最简单的测试消息比如「用一句话说明这个项目是做什么的」或者直接让它读一个文件读一下当前目录的 package.json告诉我项目名和依赖数量如果请求正确指向了 TaoToken你会看到模型正常返回内容。这一步同时验证了三件事BASE URL 可达、API KEY 有效、Model ID 正确。三者任一不对都会在这一步暴露出来。想更确定请求确实打到了 TaoToken而不是缓存或别的端点可以在发请求的同时观察网络。macOS/Linux 下可以用sudo tcpdump -i any -n host taotoken.netWindows 下用netstat或资源监视器看 opencode 进程的连接目标。看到连接指向taotoken.net就说明 BASE URL 生效了。这个方式比猜要靠谱尤其在你有多个 provider 配置的时候。另一个验证角度是看 opencode 的日志。opencode 一般会在配置目录或临时目录下写日志里面会记录请求的 endpoint。你可以ls ~/.config/opencode/找找有没有 log 相关文件或者启动时加 verbose 参数如果版本支持opencode --log-level debug日志里出现https://taotoken.net/api/v1/...这样的请求地址就实锤了。验证通过后你就可以正常用 opencode 做编码任务了。比如让它重构一个函数、生成单元测试、解释一段复杂逻辑。因为走的是统一 Key 通道你换模型只需要在/models里切换不用重新配鉴权。这也是把 BASE URL 指向 TaoToken 的实际收益配置一次多模型复用。如果你在验证阶段发现模型列表是空的或者选了模型但发消息没反应先别怀疑模型本身回到配置文件和通道探测两步排查。下一节把常见报错逐条拆开。5. 常见报错排查401、local proxy failed、reading choices、OAuth 逐条对照配置 opencode 自定义 BASE URL 时报错基本集中在四类。下面按真实错误信息逐条给排查路径。401 Unauthorized / invalid api key这是最常见的一类。opencode 发请求时带上了 Key但服务端不认。可能原因有三个Key 复制时多了空格或换行Key 已经失效或被删除apiKey字段没被正确读取。先检查配置文件里apiKey的值确保没有首尾空格。然后用 curl 单独验证这把 Keycurl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的key如果 curl 也返回 401说明 Key 本身有问题去控制台重新生成一把https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果 curl 正常但 opencode 报 401那就是配置文件没生效——检查你是不是改错了文件路径或者改了但没重启 opencode。opencode 启动时读一次配置改完要退出重进。local proxy failed / connection refused这个报错说明 opencode 尝试连接baseURL时连不上。常见于 baseURL 写成了http://而不是https://或者地址里带了多余路径。确认你的baseURL是https://taotoken.net/api/v1不要写成https://taotoken.net/api/v1/结尾多斜杠有时也会出问题也不要漏掉/v1。另外检查本机网络是否能访问外网公司内网如果有出口限制可能需要走正常的网络配置。用 curl 探一下curl -v https://taotoken.net/api/v1/models看 TLS 握手和 HTTP 状态码能定位是 DNS、连接还是协议层的问题。Error reading choices / unexpected response shape这类报错通常出现在响应解析阶段说明请求发出去了、也收到了响应但响应结构不是 opencode 期望的格式。根因多半是npm字段选的 SDK 协议和实际通道不匹配。比如通道是 OpenAI 兼容格式但你配了ai-sdk/anthropic解析就会失败。解决办法是确认 TaoToken 通道对目标模型暴露的是哪种协议然后改npm字段npm: ai-sdk/openai或者npm: ai-sdk/anthropic改完重启 opencode 再试。如果还是报错用 curl 直接看原始响应curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的key \ -H Content-Type: application/json \ -d {model:glm-5.1,messages:[{role:user,content:hi}]}看返回的 JSON 结构里有没有choices字段以及字段层级是否和 SDK 期望一致。OAuth / authentication flow 相关报错有些版本的 opencode 或某些 provider 会走 OAuth 流程如果你看到跳转浏览器授权、或者提示 OAuth token 无效说明当前 provider 被当成需要 OAuth 的服务了。走自定义 BASE URL API KEY 的模式时不应该触发 OAuth。检查配置里有没有残留的 OAuth 相关字段或者provider.default是不是指向了某个内置的 OAuth provider。把default明确指向你自定义的那个 provider并确保options里只有baseURL和apiKey。排查时记住一个原则先用 curl 把「Key BASE URL Model ID」三件套在命令行验证通过再回到 opencode 里配。这样能把网络层和配置层的问题分开不会两头猜。三件套里任何一个不对opencode 都会以各种形式报错而 curl 的输出最直接。6. 把 opencode 接到 TaoToken 之后日常怎么用更顺配置跑通只是起点。日常用 opencode 时有几个习惯能让它更稳。第一把 API KEY 从配置文件里抽出来用环境变量管理尤其是你打算把配置同步到多台机器时。虽然 opencode 对变量插值的支持要看版本但你可以用启动脚本注入TAOTOKEN_API_KEYsk-xxx opencode然后在配置里引用。这样配置文件本身可以进版本控制Key 不会泄露。第二模型列表别一次配太多。opencode 的/models选择器里条目太多反而难找建议只保留你常用的两三个每个都确认过 limit 值正确。limit 填错会导致长上下文任务被截断或者请求被服务端拒绝。第三遇到响应慢或超时先分清是模型本身慢还是通道问题。用 curl 直接打一次同样的请求对比耗时。如果 curl 快而 opencode 慢可能是 opencode 侧的处理或重试逻辑如果 curl 也慢那就是通道或模型负载问题。第四长期做编码和 Agent 任务的话关注一下用量。TaoToken 控制台能看到调用记录Coding Plan 在高频场景下比按量更省https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite需要查接入细节和参数说明时文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你更想先在网页上试模型再决定配哪个模型对话页面可以直接聊https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite最后说一个我踩过的坑改完config.json后一定要新开终端再启动 opencode。有次我在同一个终端里改完配置直接重跑结果读到的还是旧的环境变量和缓存排查了半天才发现是终端会话的问题。新开终端这个动作看着小能省掉很多莫名其妙的报错。配置文件和通道两边都确认过opencode 用起来就很顺了。