1. OpenCode 的 Plan/Build 模式到底怎么用OpenCode 跑在终端里界面是 TUI看起来极客实际上手不难。它最不同于 Cursor 的地方是两种工作模式Plan 和 Build。Plan 模式下模型只读你的代码库能搜索文件、分析符号、给实现策略但不落盘Build 模式才真正写文件、改代码、跑命令。1.1 为什么要先按 Tab 进入 Plan原文里那张“Plan vs Build”的对照说得很直白复杂功能务必先用 Plan 模式 outline 方案再切 Build 实施。我试过一个真实改动给 auth.ts 的 handleSubmit 加统一错误处理。如果直接让模型在 Build 模式下改它可能只改一个函数、漏掉调用方。切到 Plan 后模型先列出 handleSubmit 在哪些页面被引用再把每个调用点的返回约定列出来我确认方案后才动手。这样一套下来改完代码基本不用返工。1.2 Build 模式才是真正的写代码回到 Build 模式AI 才拥有文件读写和执行命令的权限。两个模式共用同一个模型提供商区别只在权限边界。Tab 键在两者之间循环切换/undo 撤销最近一次更改/redo 重做。这里要记住一点OpenCode 本身不绑定 IDE所以你在 VS Code、Cursor 或 Zed 里都能用同一个终端流程这也是原文强调“终端优先”的原因。OpenCode 的另一个卖点是多提供商支持这意味着同一个终端工具可以连不同模型。但多提供商不等于零成本接入每个 provider 都要单独申请 API Key、单独填 Base URL、单独确认模型 ID。当你要在不同任务里切换模型时这些分散的 Key 就成了新的心智负担。我在用了几天后才意识到真正需要统一的是“渠道”不是“工具”。2. 准备一把 TaoToken Key替掉每个模型各一把 Key原文里 OpenCode 支持多提供商也列出了一些免费模型体验入口。实际用的时候你会发现免费模型各有各的时效、速率限制和模型命名散落着配非常费劲。我的做法是把所有模型请求统一接到 TaoToken 的兼容 API 上Key 只维护一把Provider 只配一个。2.1 去 TaoToken 创建 Key 就两步打开官网注册登录进入控制台创建 API Key。官网地址记一下https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 。创建的 Key 形如 sk-...下文配置里统一用 YOUR_API_KEY 占位你自己替换成真实值。如果你同时要跑 Plan 和 Build 两类任务不需要为两种模式准备两把 Key一把就够。2.2 模型 ID 别猜去模型广场复制模型 ID 不要凭印象填。登录官网后打开模型广场看当时列表里的模型名。原文提过的 Grok Code Fast 1、GLM 4.7、Big Pickle 这类免费或限免模型现在是否仍可用、ID 长什么样都以模型广场当日列表为准。这样最稳。Base URL 固定为 https://taotoken.net/api 末尾不带 /v1。官网和接口是两回事官网用来管理 Key 和看用量接口地址用来填进 OpenCode。3. 把 Base URL 填进 opencode.jsonPlan 和 Build 走同一个通道OpenCode 的配置放在项目根目录的 opencode.json也可以放到全局目录 ~/.config/opencode/opencode.json。项目级配置优先适合给不同仓库指定不同模型全局配置适合统一默认通道。3.1 provider 配置示例我用的是 OpenAI 兼容方式配置 TaoToken provider配置文件长这样{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: {env:TAOTOKEN_API_KEY} }, models: { 模型ID: { name: 模型显示名 } } } } }把“模型ID”替换成模型广场复制的标识把“模型显示名”写成你能认出来的名字。保存后重启 OpenCode新 provider 才会被加载。3.2 环境变量读取 KeyapiKey 字段里写的{env:TAOTOKEN_API_KEY}是让 OpenCode 从环境变量读值别把真实 Key 直接写进 JSON。设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 对应$env:TAOTOKEN_API_KEYYOUR_API_KEY。这里再次强调Base URL 是 https://taotoken.net/api 不是 https://taotoken.net/api/v1 也不是官网首页。很多模型 SDK 会自动拼接路径OpenCode 的 provider 会把 baseURL 当作完整入口手动加 /v1 反而容易 404。4. 先 Plan 后 Build 的完整验证流程配置完别急着接大需求先用一个小改动验证通道是不是真的通了。我拿“给 auth.ts 的提交函数加错误处理”当例子跑一轮完整流程。4.1 第一轮Plan 模式只读分析进入 OpenCode 项目后按 Tab 切到 Plan 模式输入列出 auth.ts 中 handleSubmit 的调用位置说明添加错误处理会影响哪些返回场景。模型会先搜索文件、读引用再输出方案。只要它能正常回复就说明 Key 和 Base URL 都已经生效。如果你报错时有截图或设计稿也可以直接拖进终端窗口模型能根据图像理解需求这是原文新手技巧里提到的能力。4.2 第二轮Build 模式落地修改再按 Tab 切回 Build 模式输入按上面的方案用 async/await 重写 handleSubmit并添加 try/catch保持原导出签名不变。这次模型会真正修改文件。改动不满意就用 /undo 撤销。这样的两段式提问比一上来就让 AI 直接改要稳得多也符合原文“复杂功能先规划再动手”的建议。4.3 回官网对一下这次调用的账如果对话正常结束登录 TaoToken 控制台查看刚才请求有没有记录、消耗了多少 token。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 在用量页能看到请求明细。这步能帮你确认两件事Key 确实被使用以及这次调用消耗的是哪个模型的额度。5. 配置后常见的 401 和模型名报错排障按上面配置跑OpenCode 最常见的报错其实就两类都可以快速定位。5.1 401 Unauthorized 说明 Key 没读进去看到 401 先检查环境变量终端里执行 echo $TAOTOKEN_API_KEY 看是否输出你的 Key。Windows 用户看 $env:TAOTOKEN_API_KEY。如果环境变量为空说明当前终端没有加载最新的 export重新执行一次或直接写进 shell 配置文件。项目根目录的 opencode.json 会覆盖全局配置如果你在别处也配过 provider优先检查项目级文件。5.2 模型名报错说明 Base URL 通了ID 没对上如果报的是 model_not_found 或“模型不存在”说明 Base URL 和 Key 都没问题只是 models 里的键名不是模型广场的准确 ID。不要自己补日期后缀也不要猜版本号。重新打开模型广场复制完整模型 ID 粘到配置里重启 OpenCode 再试。提示OpenCode 是终端 TUI 程序改完配置后记得完全退出再启动让环境变量和配置文件重新加载否则仍会读到旧的 provider 设置。5.3 快捷键和 AGENTS.md 的上下文加成排障期间我顺手整理了快捷键/undo 撤销、/redo 重做、 模糊搜索项目文件、Tab 切换 Plan/Build、CmdEscMac或 CtrlEscWindows/Linux进入 IDE 分屏视图。另外在项目根目录维护一份 AGENTS.md写出项目结构、构建命令和编码约定Plan 模式的分析结果会明显更准这也是原文新手技巧里提到的上下文来源。6. 模型切换和跑通后的下一步完成上面的验证流程你已经有了一个走统一通道的 OpenCode 环境。唯一还需要手动改的就是 models 里的模型映射。6.1 先规划再实施模型也能分工我现在的习惯是Plan 阶段用上下文窗口大、擅长阅读代码的模型Build 阶段切成代码补全更果断的模型。两种模式共用同一把 TaoToken Key切换模型时不用再去找另一个 Key只改映射表即可。到底哪个模型更适合当前阶段的代码量打开模型广场对比列表参数比听别人推荐更靠谱。6.2 跑通之后接着做的事如果你还没有创建正式 Key最顺手的下一步是打开 创建 Key 页面 生成一把用于日常开发想先不碰终端可以在 TaoToken 模型对话 里用同一把 Key 发条消息验证模型选择长期写代码再看 Coding Plan 的套餐是否比按量更划算。OpenCode 跑在本地按默认配置代码不会离开机器把 Key 配好之后就在终端里放开来试吧。
OpenCode 跑 Plan/Build 任务：Key 用 TaoToken
1. OpenCode 的 Plan/Build 模式到底怎么用OpenCode 跑在终端里界面是 TUI看起来极客实际上手不难。它最不同于 Cursor 的地方是两种工作模式Plan 和 Build。Plan 模式下模型只读你的代码库能搜索文件、分析符号、给实现策略但不落盘Build 模式才真正写文件、改代码、跑命令。1.1 为什么要先按 Tab 进入 Plan原文里那张“Plan vs Build”的对照说得很直白复杂功能务必先用 Plan 模式 outline 方案再切 Build 实施。我试过一个真实改动给 auth.ts 的 handleSubmit 加统一错误处理。如果直接让模型在 Build 模式下改它可能只改一个函数、漏掉调用方。切到 Plan 后模型先列出 handleSubmit 在哪些页面被引用再把每个调用点的返回约定列出来我确认方案后才动手。这样一套下来改完代码基本不用返工。1.2 Build 模式才是真正的写代码回到 Build 模式AI 才拥有文件读写和执行命令的权限。两个模式共用同一个模型提供商区别只在权限边界。Tab 键在两者之间循环切换/undo 撤销最近一次更改/redo 重做。这里要记住一点OpenCode 本身不绑定 IDE所以你在 VS Code、Cursor 或 Zed 里都能用同一个终端流程这也是原文强调“终端优先”的原因。OpenCode 的另一个卖点是多提供商支持这意味着同一个终端工具可以连不同模型。但多提供商不等于零成本接入每个 provider 都要单独申请 API Key、单独填 Base URL、单独确认模型 ID。当你要在不同任务里切换模型时这些分散的 Key 就成了新的心智负担。我在用了几天后才意识到真正需要统一的是“渠道”不是“工具”。2. 准备一把 TaoToken Key替掉每个模型各一把 Key原文里 OpenCode 支持多提供商也列出了一些免费模型体验入口。实际用的时候你会发现免费模型各有各的时效、速率限制和模型命名散落着配非常费劲。我的做法是把所有模型请求统一接到 TaoToken 的兼容 API 上Key 只维护一把Provider 只配一个。2.1 去 TaoToken 创建 Key 就两步打开官网注册登录进入控制台创建 API Key。官网地址记一下https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 。创建的 Key 形如 sk-...下文配置里统一用 YOUR_API_KEY 占位你自己替换成真实值。如果你同时要跑 Plan 和 Build 两类任务不需要为两种模式准备两把 Key一把就够。2.2 模型 ID 别猜去模型广场复制模型 ID 不要凭印象填。登录官网后打开模型广场看当时列表里的模型名。原文提过的 Grok Code Fast 1、GLM 4.7、Big Pickle 这类免费或限免模型现在是否仍可用、ID 长什么样都以模型广场当日列表为准。这样最稳。Base URL 固定为 https://taotoken.net/api 末尾不带 /v1。官网和接口是两回事官网用来管理 Key 和看用量接口地址用来填进 OpenCode。3. 把 Base URL 填进 opencode.jsonPlan 和 Build 走同一个通道OpenCode 的配置放在项目根目录的 opencode.json也可以放到全局目录 ~/.config/opencode/opencode.json。项目级配置优先适合给不同仓库指定不同模型全局配置适合统一默认通道。3.1 provider 配置示例我用的是 OpenAI 兼容方式配置 TaoToken provider配置文件长这样{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: {env:TAOTOKEN_API_KEY} }, models: { 模型ID: { name: 模型显示名 } } } } }把“模型ID”替换成模型广场复制的标识把“模型显示名”写成你能认出来的名字。保存后重启 OpenCode新 provider 才会被加载。3.2 环境变量读取 KeyapiKey 字段里写的{env:TAOTOKEN_API_KEY}是让 OpenCode 从环境变量读值别把真实 Key 直接写进 JSON。设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 对应$env:TAOTOKEN_API_KEYYOUR_API_KEY。这里再次强调Base URL 是 https://taotoken.net/api 不是 https://taotoken.net/api/v1 也不是官网首页。很多模型 SDK 会自动拼接路径OpenCode 的 provider 会把 baseURL 当作完整入口手动加 /v1 反而容易 404。4. 先 Plan 后 Build 的完整验证流程配置完别急着接大需求先用一个小改动验证通道是不是真的通了。我拿“给 auth.ts 的提交函数加错误处理”当例子跑一轮完整流程。4.1 第一轮Plan 模式只读分析进入 OpenCode 项目后按 Tab 切到 Plan 模式输入列出 auth.ts 中 handleSubmit 的调用位置说明添加错误处理会影响哪些返回场景。模型会先搜索文件、读引用再输出方案。只要它能正常回复就说明 Key 和 Base URL 都已经生效。如果你报错时有截图或设计稿也可以直接拖进终端窗口模型能根据图像理解需求这是原文新手技巧里提到的能力。4.2 第二轮Build 模式落地修改再按 Tab 切回 Build 模式输入按上面的方案用 async/await 重写 handleSubmit并添加 try/catch保持原导出签名不变。这次模型会真正修改文件。改动不满意就用 /undo 撤销。这样的两段式提问比一上来就让 AI 直接改要稳得多也符合原文“复杂功能先规划再动手”的建议。4.3 回官网对一下这次调用的账如果对话正常结束登录 TaoToken 控制台查看刚才请求有没有记录、消耗了多少 token。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 在用量页能看到请求明细。这步能帮你确认两件事Key 确实被使用以及这次调用消耗的是哪个模型的额度。5. 配置后常见的 401 和模型名报错排障按上面配置跑OpenCode 最常见的报错其实就两类都可以快速定位。5.1 401 Unauthorized 说明 Key 没读进去看到 401 先检查环境变量终端里执行 echo $TAOTOKEN_API_KEY 看是否输出你的 Key。Windows 用户看 $env:TAOTOKEN_API_KEY。如果环境变量为空说明当前终端没有加载最新的 export重新执行一次或直接写进 shell 配置文件。项目根目录的 opencode.json 会覆盖全局配置如果你在别处也配过 provider优先检查项目级文件。5.2 模型名报错说明 Base URL 通了ID 没对上如果报的是 model_not_found 或“模型不存在”说明 Base URL 和 Key 都没问题只是 models 里的键名不是模型广场的准确 ID。不要自己补日期后缀也不要猜版本号。重新打开模型广场复制完整模型 ID 粘到配置里重启 OpenCode 再试。提示OpenCode 是终端 TUI 程序改完配置后记得完全退出再启动让环境变量和配置文件重新加载否则仍会读到旧的 provider 设置。5.3 快捷键和 AGENTS.md 的上下文加成排障期间我顺手整理了快捷键/undo 撤销、/redo 重做、 模糊搜索项目文件、Tab 切换 Plan/Build、CmdEscMac或 CtrlEscWindows/Linux进入 IDE 分屏视图。另外在项目根目录维护一份 AGENTS.md写出项目结构、构建命令和编码约定Plan 模式的分析结果会明显更准这也是原文新手技巧里提到的上下文来源。6. 模型切换和跑通后的下一步完成上面的验证流程你已经有了一个走统一通道的 OpenCode 环境。唯一还需要手动改的就是 models 里的模型映射。6.1 先规划再实施模型也能分工我现在的习惯是Plan 阶段用上下文窗口大、擅长阅读代码的模型Build 阶段切成代码补全更果断的模型。两种模式共用同一把 TaoToken Key切换模型时不用再去找另一个 Key只改映射表即可。到底哪个模型更适合当前阶段的代码量打开模型广场对比列表参数比听别人推荐更靠谱。6.2 跑通之后接着做的事如果你还没有创建正式 Key最顺手的下一步是打开 创建 Key 页面 生成一把用于日常开发想先不碰终端可以在 TaoToken 模型对话 里用同一把 Key 发条消息验证模型选择长期写代码再看 Coding Plan 的套餐是否比按量更划算。OpenCode 跑在本地按默认配置代码不会离开机器把 Key 配好之后就在终端里放开来试吧。