OpenCode 装 Skill，模型 Base URL 改到 TaoToken 再对话

OpenCode 装 Skill 的流程本身不复杂真正让人卡住的是Skill 装好了OpenCode 却没有一条能用的模型通道。你可以在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册 TaoToken、创建 API Key再把 OpenCode 的 Base URL 指到 https://taotoken.net/api Skill 触发后的模型请求才算真正跑通。原文路径是npm install -g opencode、npx skills add、SKILL.md落到.opencode/skill/最后在opencode交互式对话里输入“使用 web-search 技能搜索最新的 AI 新闻”。这条路径每一步都依赖模型通道。如果 Base URL 还是空、Key 没配、或者模型 ID 填错npx skills list能看到 Skill对话里却只会返回 401、404 或模型不存在。下面按原文节奏走一遍把 TaoToken 只放在拿 Key 和填 Base URL 这两个动作上不替代npx skills add也不改 OpenCode 的 Skill 触发逻辑。1. 从 npm install -g opencode 开始把 Skill 依赖装齐1.1 全局安装 OpenCode 与确认版本OpenCode 的安装入口是 npm 全局包。官方给的命令很直接npm install -g opencode装完不要急着进对话先确认命令在 PATH 里opencode --version如果提示command not found先看 npm 全局 bin 目录有没有进 PATH。用npm bin -g或npm prefix -g看路径再把对应 bin 加进 shell 配置。Windows 上通常是%APPDATA%\npmmacOS / Linux 常见是/usr/local/bin或~/.npm-global/bin。这一步和模型通道无关但它是后面所有 OpenCode 操作的基础。如果全局安装权限报错不要直接sudo npm install -g更稳的做法是配置 npm prefix 到用户目录再重新安装。也可以用npx opencode临时跑一次但 Skill 安装和后续配置仍建议用全局命令路径更稳定。1.2 npx skills add 把 web-search 技能落到 .opencode/skill/OpenCode 本身不带你要的业务技能Skill 要通过npx skills add安装。以 web-search 为例npx skills add web-search如果这个命令是交互式的按提示把目标选成 OpenCode。安装完成后Skill 文件会落到项目里的.opencode/skill/skill-name/SKILL.md。web-search 对应的位置就是.opencode/skill/web-search/SKILL.md用npx skills list可以确认当前环境识别到了哪些 Skillnpx skills list输出里应该能看到 web-search。注意这里只能证明文件装上了不能证明 OpenCode 能拿它去请求模型。很多人把npx skills list有输出当成“已经跑通”结果进opencode发一句话模型请求直接失败。Skill 是说明书模型通道才是发动机说明书放对了发动机没点火车还是不动。1.3 项目级和用户级 Skill 的区别npx skills add默认可能装到当前项目的.opencode/skill/下也可能按工具提示装到用户级目录。项目级 Skill 的好处是跟着仓库走换项目不会互相污染用户级 Skill 的好处是每个项目都能用。原文给的是.opencode/skill/skill-name/SKILL.md你就先按这个路径检查。如果当前目录下没有再在 home 目录附近找 OpenCode 的配置目录。无论装在哪一级最后都要保证npx skills list能列出来并且opencode启动时读取的是同一个工作目录。不要在一个项目里装 Skill却跑到另一个目录启动 OpenCode那样 Skill 列表对不上对话里自然也不会触发。2. SKILL.md 放在哪OpenCode 怎么识别 web-search2.1 .opencode/skill/ /SKILL.md 的目录结构装好之后先看目录find .opencode/skill -maxdepth 3 -name SKILL.md正常应该出现.opencode/skill/web-search/SKILL.md。这个文件不是普通 README它通常包含技能名、描述、触发条件和使用说明。OpenCode 启动时会扫描.opencode/skill/下的子目录把每个SKILL.md注册成可用技能。描述写得越清楚模型越容易在用户说“搜一下最新 AI 新闻”时想到调用 web-search。如果你把SKILL.md放在.opencode/skills/或者文件名写成skill.mdOpenCode 可能不认。原文路径是单数skill先按这个来。改完SKILL.md后重启opencode会话让技能列表重新加载。2.2 为什么 npx skills list 能看到对话里却调不动模型npx skills list只扫描本地文件它不关心模型通道是否可用。进入opencode后你输入“使用 web-search 技能搜索最新的 AI 新闻”OpenCode 会把当前对话、可用技能列表和SKILL.md描述一起发给模型由模型决定是否调用 web-search。如果 Base URL 没配、API Key 为空、模型 ID 写错请求在到达模型之前就被拦下来了。表现可能是终端直接报401 Unauthorized说明 Key 没读到或 Key 无效报404 Not Found常见原因是 Base URL 多了/v1或者路径拼错报模型不存在说明YOUR_MODEL_ID不是模型广场里的真实 ID一直转圈或连接超时检查网络、Base URL 和当前 shell 的环境变量。这时候不要反复改SKILL.md先把模型通道配通。TaoToken 在这里只提供 Key 和 Base URL不替换npx skills add也不改 OpenCode 的 Skill 触发逻辑。你需要的是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册、创建 Key然后把 OpenCode 的模型配置指过去。3. 对话触发 Skill 之前先把模型通道切到 TaoToken3.1 打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key先去 TaoToken 注册账号进入控制台创建 API Key。创建出来的 Key 只显示一次或少量次数复制后先放到安全位置。本文统一用YOUR_API_KEY占位不要把它提交到 Git。模型 ID 不要凭记忆写去模型广场看当时可用的列表选一个你要用的对话模型 ID把它记成YOUR_MODEL_ID。Base URL 固定填https://taotoken.net/api末尾不要加/v1也不要带任何查询参数。官网落地页和接口地址是两回事注册、看模型、创建 Key、看用量走 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 填进 OpenCode 的 Base URL 只写https://taotoken.net/api。3.2 在 opencode.json 里填 Base URL https://taotoken.net/api 和 YOUR_API_KEYOpenCode 的模型配置放在项目根目录的opencode.json或者用户级~/.config/opencode/opencode.json。下面是一个 OpenAI 兼容 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: { YOUR_MODEL_ID: { name: YOUR_MODEL_ID } } } }, model: taotoken/YOUR_MODEL_ID }然后设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 用$env:TAOTOKEN_API_KEYYOUR_API_KEY如果你不想用环境变量也可以把apiKey直接写成YOUR_API_KEY但不推荐把 Key 留在配置文件里。保存后重启opencode让它重新读取opencode.json。这里再强调一次baseURL是https://taotoken.net/api不是https://taotoken.net/api/v1也不是带 UTM 的官网地址。官网地址只用来注册和创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 。4. 回到 opencode 交互式对话验证 web-search 技能触发4.1 npx skills list 确认安装再输入技能需求配置保存后先回到项目目录确认 Skill 还在npx skills list看到 web-search 后启动 OpenCodeopencode在交互式对话里输入使用 web-search 技能搜索最新的 AI 新闻如果模型通道正常OpenCode 会把这句话连同 web-search 的技能描述发给模型模型决定调用 web-search然后走你配置的 Base URL 去请求。你会看到工具调用或搜索过程的输出最后返回结果。如果模型没有自动触发可以把需求写得更明确比如“请调用 web-search 技能搜索今天关于 AI 编程工具的新闻并列出三条”。但不要跑到另一个目录启动也不要换一个没有配opencode.json的终端。4.2 看返回结果和用量排查 401 / 404 / 模型名错误验证时按这个顺序排终端如果报401先检查TAOTOKEN_API_KEY是否在当前 shell 生效。echo $TAOTOKEN_API_KEY看有没有值或者直接在opencode.json里临时用明文 Key 测试。如果报404九成是 Base URL 写成了https://taotoken.net/api/v1或者多了一个斜杠。改回https://taotoken.net/api。如果提示模型不存在回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场复制准确的模型 ID 替换YOUR_MODEL_ID。不要用gpt-5这类没在列表里出现的名字当正式配置。如果 Skill 完全没被提到检查.opencode/skill/web-search/SKILL.md是否存在以及npx skills list是否在同一个项目目录下执行。如果请求成功但结果不对先看模型返回再调整SKILL.md的描述不要一上来就改 Base URL。排障时记住TaoToken 只负责 Key 和 Base URLSkill 触发逻辑仍在 OpenCode 和SKILL.md里。5. 配完之后模型对话、Coding Plan 与下一次 Skill 调用5.1 在模型对话里用同一把 Key 发测试消息OpenCode 里跑通一次 web-search 后最好去 TaoToken 模型对话 用同一把 Key 发一条测试消息。这样能把问题切开如果模型对话页正常、OpenCode 报错问题就在 OpenCode 配置或 Skill 触发如果模型对话页也报错问题在 Key、模型 ID 或账户状态。模型对话页还能让你直观看到当前模型能不能用不用每次都回终端改配置。测试消息不需要复杂发一句“你好测试模型通道”即可。确认返回后再回 OpenCode 重跑 web-search两边都通就说明链路完整。5.2 长期写代码看 Coding PlanKey 管理去控制台如果你打算把 OpenCode 当日常编程工具Skill 会越来越多模型请求也会变频繁。这时候可以去 Coding Plan 看套餐是否匹配你的用量。Key 的管理和新建在 控制台 API Keys 换模型、看用量、查调用记录也都在那边。OpenCode 这边只保留opencode.json里的baseURL和模型 IDKey 尽量走环境变量。以后换模型改YOUR_MODEL_ID和model字段即可不用动 Skill 目录。要是你同时用 Claude Code 接同一把 Key可以再看 Claude Code 接入文档 但 OpenCode 的 Skill 触发仍然归 OpenCode 自己管。5.3 换模型不重装 Skill只动 opencode.jsonOpenCode 的 Skill 文件和模型配置是两套东西。SKILL.md决定“什么时候用技能”opencode.json决定“请求发到哪个 Base URL、用哪个模型 ID”。以后你在模型广场换了模型不需要删掉.opencode/skill/web-search/只要把opencode.json里的YOUR_MODEL_ID和model字段替换掉重启 OpenCode 就能继续用同一个 web-search。反过来如果你改了SKILL.md的触发描述也不用动 Key 和 Base URL。把这两层分开排障会快很多技能不触发先看.opencode/skill和npx skills list请求失败先看opencode.json里的baseURL、apiKey和模型 ID。配完之后别急着关终端回到 OpenCode 里再发一次 web-search 请求确认这次调用在控制台里能看到记录。拿 Key、换模型、看用量都在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end Base URL 始终填https://taotoken.net/api。Skill 装没装好看npx skills list模型通不通看一次真实对话返回。两者都过了OpenCode 的 Skill 才算真正可用。