1. 為什么 Agent Skills 一上手就卡在配置Agent Skills 是 Anthropic 牽頭維護(hù)的開(kāi)放標(biāo)準(zhǔn)用一套規(guī)范化命名的文件夾把 Markdown 文檔、可執(zhí)行腳本和素材文件組合成可復(fù)用的技能包。它能讓 OpenCode、Claude 這類(lèi)工具在特定任務(wù)上表現(xiàn)得更像懂行的老手而不是每次都要你從頭解釋背景。適合誰(shuí)適合已經(jīng)在用 OpenCode 寫(xiě)代碼、同時(shí)又在 Claude 里做對(duì)話(huà)或 Agent 實(shí)驗(yàn)的開(kāi)發(fā)者尤其是那些被多套 Key、多個(gè) base_url 折騰到頭疼的人。我自己的痛點(diǎn)很典型OpenCode 要一份config.tomlClaude 側(cè)要一份settings.json兩邊各自維護(hù) API Key 和通道地址。Skills 本身只是文件夾放對(duì)路徑就能被識(shí)別但真正讓 Skills 跑起來(lái)的前提是——模型請(qǐng)求得先通。于是問(wèn)題就變成了怎么讓 OpenCode 和 Claude 共用一套 Key、一條通道同時(shí)不破壞各自的配置文件結(jié)構(gòu)。這篇就按這個(gè)思路走先用 TaoToken 把 Key 和 API 通道統(tǒng)一再分別給出settings.json與config.toml的可復(fù)制骨架最后用一個(gè)最小調(diào)用驗(yàn)證 Skills 是否真的被加載。全程不碰復(fù)雜概念你照著填就能跑。2. TaoToken 前置統(tǒng)一 Key 與 API 通道TaoToken 在這里扮演的角色是統(tǒng)一入口你只需要在它這里拿一個(gè) KeyOpenCode 和 Claude 兩側(cè)都指向同一個(gè) API 地址省掉分別申請(qǐng)、分別記賬的麻煩。對(duì) Agent Skills 這種需要頻繁調(diào)用模型的場(chǎng)景來(lái)說(shuō)統(tǒng)一通道能明顯減少這個(gè)工具用哪個(gè) Key的心智負(fù)擔(dān)。先做兩件事。第一打開(kāi)官網(wǎng) https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊(cè)并登錄。第二進(jìn)入控制臺(tái)創(chuàng)建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。創(chuàng)建后把 Key 復(fù)制出來(lái)形如sk-xxxx后面兩個(gè)配置文件都要用它。API 通道地址統(tǒng)一用 https://taotoken.net/api 注意這個(gè)地址不帶任何查詢(xún)參數(shù)直接填在配置里即可。如果你后面要單獨(dú)管理 Key可以走 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。提示Key 只顯示一次建議創(chuàng)建后立刻存到密碼管理器。不要寫(xiě)進(jìn)會(huì)提交到 Git 的公開(kāi)倉(cāng)庫(kù)。到這里前置就完成了一個(gè) Key一個(gè) API 地址。接下來(lái)分別落到 OpenCode 和 Claude 的配置文件里。3. 可復(fù)制配置settings.json 與 config.toml 骨架3.1 Claude 側(cè) settings.json 骨架Claude 側(cè)的配置通常放在用戶(hù)配置目錄下的settings.json。核心是把 API 通道和 Key 指到 TaoToken。下面是一份可直接改的骨架把sk-你的Key替換成上一步拿到的值{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key }, permissions: { allow: [] } }這里ANTHROPIC_BASE_URL決定請(qǐng)求走哪條通道ANTHROPIC_API_KEY決定用哪個(gè)身份。兩個(gè)字段填對(duì)Claude 側(cè)的模型請(qǐng)求就能通。Skills 文件夾本身不在這份配置里聲明它靠文件系統(tǒng)路徑被識(shí)別配置只負(fù)責(zé)讓模型能回話(huà)。3.2 OpenCode 側(cè) config.toml 骨架OpenCode 用的是config.toml。它的結(jié)構(gòu)比 JSON 更直觀重點(diǎn)是 provider 段和 model 段。下面這份骨架把通道指向 TaoToken[provider.taotoken] base_url https://taotoken.net/api api_key sk-你的Key [model] provider taotoken name claude-sonnetprovider.taotoken是你自定義的 provider 名base_url和api_key與 Claude 側(cè)保持一致這樣兩邊共用同一套憑證。model.name按你實(shí)際要用的模型填這里用claude-sonnet占位。3.3 Skills 文件夾放哪配置只管通道Skills 要靠路徑被加載。OpenCode 會(huì)從項(xiàng)目級(jí).opencode/skills/和用戶(hù)級(jí)~/.config/opencode/skills/讀取。你可以手動(dòng)把 Skill 文件夾拷進(jìn)去也可以用官方命令行工具npx skills add owner/repo比如裝一個(gè)安全方向的 Skillnpx skills add tanweai/wooyun-legacyWindows 上跑這條命令前需要先裝好 Git否則npx skills add拉取倉(cāng)庫(kù)會(huì)失敗。裝完后確認(rèn)目錄里出現(xiàn)了對(duì)應(yīng)的 Skill 文件夾里面應(yīng)該有SKILL.md之類(lèi)的描述文件。4. 驗(yàn)證請(qǐng)求一次最小調(diào)用確認(rèn) Skills 加載配置寫(xiě)完別急著上復(fù)雜任務(wù)先做一次最小驗(yàn)證。分兩步先確認(rèn)模型通道通再確認(rèn) Skills 被識(shí)別。第一步在 OpenCode 里發(fā)一條最簡(jiǎn)單的請(qǐng)求比如讓它讀一個(gè)本地文件并總結(jié)。如果返回正常說(shuō)明config.toml里的通道和 Key 生效了。Claude 側(cè)同理發(fā)一條普通對(duì)話(huà)能回就說(shuō)明settings.json沒(méi)問(wèn)題。第二步驗(yàn)證 Skills 是否加載。在 OpenCode 里輸入一個(gè)和已裝 Skill 相關(guān)的任務(wù)描述觀察它是否調(diào)用了 Skill 里的腳本或文檔。更直接的辦法是看啟動(dòng)日志或技能列表確認(rèn)~/.config/opencode/skills/下的文件夾被掃描到。如果你想單獨(dú)驗(yàn)證模型對(duì)話(huà)是否正?？梢宰吣Ｐ蛯?duì)話(huà)入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 發(fā)一條消息看返回。這一步和配置文件是同一套 Key能通就說(shuō)明憑證沒(méi)問(wèn)題。實(shí)測(cè)下來(lái)最容易出問(wèn)題的不是 Key 本身而是路徑和字段名。下面把常見(jiàn)坑列一下。5. 本篇常見(jiàn)錯(cuò)排查報(bào)錯(cuò)一401 未授權(quán)。九成是 Key 復(fù)制時(shí)帶了空格或者settings.json里字段名寫(xiě)成了ANTHROPIC_KEY而不是ANTHROPIC_API_KEY。檢查字段名和值重新粘貼一次。報(bào)錯(cuò)二請(qǐng)求超時(shí)或連接失敗。檢查base_url是否寫(xiě)成了帶路徑的形式。正確值是https://taotoken.net/api不要在后面加/v1之類(lèi)的后綴除非文檔明確要求。報(bào)錯(cuò)三Skills 不生效。先確認(rèn)文件夾層級(jí)對(duì)不對(duì)。OpenCode 讀的是.opencode/skills/或~/.config/opencode/skills/少一層或多一層都不會(huì)被識(shí)別。再確認(rèn) Skill 文件夾里有描述文件空文件夾不會(huì)被加載。報(bào)錯(cuò)四npx skills add失敗。Windows 上先確認(rèn) Git 已安裝且在 PATH 里。如果公司網(wǎng)絡(luò)限制 npm 源換一個(gè)可用的 registry 再試。報(bào)錯(cuò)五兩邊配置沖突。如果你之前給 OpenCode 或 Claude 配過(guò)別的通道記得把舊的環(huán)境變量清掉否則可能出現(xiàn)配置改了但請(qǐng)求還走老路的情況。環(huán)境變量?jī)?yōu)先級(jí)通常高于配置文件。排查順序建議先驗(yàn) Key再驗(yàn)通道最后驗(yàn) Skills 路徑。這樣能快速定位是哪一層出的問(wèn)題。6. 長(zhǎng)期編碼與 Agent 場(chǎng)景的下一步如果你只是偶爾用一下 Skills上面這套配置夠用了。但如果你打算把 OpenCode 當(dāng)日常編碼工具、或者跑長(zhǎng)期 Agent 任務(wù)建議把 Key 管理做得更規(guī)范一點(diǎn)。Coding Plan 入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 適合需要穩(wěn)定通道和額度管理的場(chǎng)景。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有針對(duì)不同工具的字段說(shuō)明配置卡住時(shí)對(duì)著查比猜快。Claude Code 相關(guān)的接入說(shuō)明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 如果你同時(shí)用 Claude Code可以一并把通道統(tǒng)一掉。最后給一個(gè)實(shí)用習(xí)慣把settings.json和config.toml里的 Key 抽成環(huán)境變量引用而不是硬編碼。這樣換 Key 時(shí)只改一處也避免誤提交。Skills 本身會(huì)越來(lái)越多通道統(tǒng)一之后你只需要關(guān)心裝哪個(gè) Skill不用再關(guān)心這個(gè)工具用哪個(gè) Key。