1. Claude Code 搜不到新東西卡點其實不在模型Claude Code 本身不帶聯(lián)網(wǎng)搜索能力這是很多人第一次認(rèn)真給它掛搜索 Skill 或者 MCP 時撞上的第一堵墻。模型再強訓(xùn)練截止之后發(fā)生的更新它一概不知道你問一個 2026 年才發(fā)布的庫和它的新版接口它要么給你舊參數(shù)要么一本正經(jīng)地編一段看起來很專業(yè)的假文檔。我前后裝過五六種搜索方案有要自己申請搜索 API Key 的有把整頁 HTML 塞回上下文的有返回一堆 2019 年鏈接的共同點是配置成本高、結(jié)果不穩(wěn)定用兩天就想卸掉。這篇要講的是我自己跑通的一條組合用 Rust 寫的單二進(jìn)制搜索工具 gsearch-cli 做聯(lián)網(wǎng)搜索用 Claude Code 的 Skill 機制把它掛上去同時把 Claude Code 的 Base URL 指向 TaoToken。關(guān)鍵在于把兩件事拆開搜索走 gsearch-cli 復(fù)用 Gemini CLI 的 OAuth 認(rèn)證模型通道走 TaoToken。這樣 Skill 每輪把搜索結(jié)果塞回上下文時真正燒 Token 的那條鏈路是你自己可控的而不是被搜索工具的認(rèn)證和額度牽著走。適合誰看已經(jīng)在用 Claude Code、想讓 Agent 查最新文檔和實時信息、又不想在 Prompt 里寫一大段「請使用搜索工具」說明的人。下面所有步驟都能直接復(fù)制。1.1 大多數(shù)搜索插件為什么用兩天就卸先說清楚痛點不然你沒法判斷換工具是不是白折騰。第一類是基于網(wǎng)頁抓取的方案返回的是壓縮過的 HTML 或者一大段無語義文本模型要從里面撈答案上下文瞬間被塞滿還沒引用編號可以核對。第二類是要求你自己注冊某家搜索 API、填 Key、配額度的方案配置流程比寫業(yè)務(wù)代碼還長Key 過期了你還得自己發(fā)現(xiàn)。第三類是搜索能力確實有但結(jié)果不帶引用編號和原文鏈接模型說「根據(jù)最新文檔」你沒法點進(jìn)去看它到底看的是哪一頁。還有一個常被忽略的成本Skill 每輪把搜索結(jié)果追加進(jìn)上下文這些內(nèi)容最終都要經(jīng)過 Claude Code 的模型通道計費。搜索工具本身免費不代表整套鏈路免費。所以選搜索工具要看兩件事——搜索質(zhì)量和它塞回上下文的體積后者決定了你每個月的模型開銷。1.2 gsearch-cli 只管一件事而且管得干凈gsearch-cli 是一個 Rust 寫的單二進(jìn)制命令行工具啟動幾乎沒有延遲體積小到放進(jìn) PATH 里都不占地方。它底層調(diào)用的是 Gemini API 的 grounded search比爬蟲方案穩(wěn)結(jié)果自帶引用編號和原文鏈接模型引用哪一條你能直接點開驗證。最省事的一點是它復(fù)用了 Gemini CLI 的 OAuth 認(rèn)證如果你的機器上裝過官方 gemini-cli 并登錄過它直接讀~/.gemini/oauth_creds.json里的 token 就能用裝完不彈授權(quán)窗口。沒用過 Gemini CLI 也沒關(guān)系它自帶一個本地 OAuth 流程第一次運行自動打開瀏覽器點一下授權(quán)即可。access token 的刷新它在后臺自己做不用你記過期時間。企業(yè)內(nèi)網(wǎng)那套自定義根證書和網(wǎng)絡(luò)環(huán)境變量它也會自動讀不用手動塞 ca 文件。MIT 協(xié)議開源隨便改。2. 掛 Skill 之前先把模型通道和搜索通道拆開很多人裝完搜索工具就直接進(jìn) Claude Code 試然后發(fā)現(xiàn)響應(yīng)變慢、額度消耗變快以為是搜索壞了。其實搜索只負(fù)責(zé)「把結(jié)果拿回來」拿回來的內(nèi)容要經(jīng)過 Claude Code 的模型通道才能變成回答。這兩條鏈路是獨立的得分開配置、分開驗證。2.1 兩條鏈路分開之后各管什么搜索鏈路Claude Code 通過 Skill 觸發(fā)gsearch命令gsearch-cli 用 Gemini OAuth 發(fā)請求返回帶引用編號的搜索結(jié)果文本。這條鏈路不經(jīng)過任何模型通道和你的 Claude Code 額度無關(guān)。模型鏈路Skill 把搜索文本追加進(jìn)上下文Claude Code 帶著這段文本去請求模型這條鏈路才是計費和限速發(fā)生的地方。把它指向 TaoToken你就有一個獨立的 Key、獨立的額度視圖出問題時也容易定位到底是搜索掛了還是模型通道掛了。2.2 先拿一把 Key再去改 Base URL打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsearch_skill 注冊賬號后進(jìn)控制臺在 API Keys 頁面創(chuàng)建一把 Key形如sk-開頭的一長串。這串東西只顯示一次復(fù)制到本地密碼管理器或者臨時文件里?？刂婆_入口和 Key 管理頁面在這里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_gsearch_skillutm_campaignrewrite 。這里有個容易忽略的點不要拿搜索工具的憑證去填模型通道也不要拿模型 Key 去填搜索工具。兩套憑證服務(wù)的是兩件完全不同的事混用只會讓你在排查時失去線索。3. 可復(fù)制配置從裝二進(jìn)制到 Skill 落地下面按順序來每一步都能單獨驗證。建議不要跳步尤其是第 3.2 步的命令行自檢它是后面所有排查的基線。3.1 裝 gsearch-climacOS 用 Homebrew 最省事brew install aeroxy/tap/gsearch有 Rust 環(huán)境的話用 cargocargo install gsearch-cli裝完確認(rèn)一下二進(jìn)制在 PATH 里這一步的結(jié)果后面要寫進(jìn) Skill 配置which gsearch gsearch --version如果which輸出為空把 cargo 的 bin 目錄加進(jìn) shell 配置常見位置是~/.cargo/binecho export PATH$HOME/.cargo/bin:$PATH ~/.zshrc source ~/.zshrc3.2 先讓搜索單獨跑通不要直接進(jìn) Claude Code先在終端里確認(rèn)搜索本身沒壞。第一次運行會走 OAuthgsearch --login瀏覽器點完授權(quán)后直接搜一條實時性強的查詢gsearch 新加坡天氣正常輸出應(yīng)該是一段結(jié)構(gòu)化文本包含結(jié)果條目、引用編號和原文鏈接。想換賬號重新授權(quán)就用gsearch --login它會覆蓋本地憑證文件。搜索語句不需要加引號中文直接跟在命令后面就行。如果這一步就有問題后面全部不用做先把這一步解決。3.3 把 Skill 丟進(jìn) skills 目錄gsearch-cli 項目里自帶 Claude Code Skill 文件。把它放到你所用 Claude Code 插件的skills/目錄下常見做法是給每個 Skill 建一個獨立子目錄mkdir -p ~/.claude/skills/gsearch cp gsearch-cli倉庫路徑/skills/gsearch/SKILL.md ~/.claude/skills/gsearch/Skill 文件里最關(guān)鍵的是兩樣?xùn)|西什么時候觸發(fā)、以及怎么調(diào)用。參考結(jié)構(gòu)如下重點是 description 要寫清楚「需要最新信息時才用」不然模型會濫用它每輪都去搜一遍上下文和額度都會很難看。--- name: gsearch description: 當(dāng)問題涉及最新文檔、版本變化、實時數(shù)據(jù)或訓(xùn)練截止之后的信息時使用。調(diào)用 gsearch 命令獲取帶引用編號的搜索結(jié)果。 allowed-tools: Bash(gsearch:*) --- # gsearch 需要聯(lián)網(wǎng)信息時執(zhí)行 bash gsearch 查詢詞 返回結(jié)果帶有引用編號和原文鏈接回答時應(yīng)保留引用編號。二進(jìn)制路徑建議在 Skill 里寫絕對路徑或者確認(rèn) Claude Code 啟動時繼承的 PATH 里包含gsearch。后者經(jīng)常出問題——你在終端里which gsearch有輸出但 Claude Code 作為 GUI 或由別的進(jìn)程拉起時 PATH 不一樣Skill 就找不到命令。寫絕對路徑最穩(wěn)which gsearch # 輸出示例/opt/homebrew/bin/gsearch把這個絕對路徑填進(jìn) Skill 的調(diào)用說明里。3.4 把 Base URL 指向 TaoToken現(xiàn)在配置模型通道。Claude Code 讀取ANTHROPIC_BASE_URL和對應(yīng)的認(rèn)證變量寫進(jìn) shell 配置讓每次開終端都生效echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc echo export ANTHROPIC_AUTH_TOKENsk-你剛才創(chuàng)建的Key ~/.zshrc source ~/.zshrc注意 Base URL 就是https://taotoken.net/api不要加/v1不要帶任何官網(wǎng)后綴或查詢參數(shù)。SDK 會自己在后面拼具體路徑你多寫一段就會變成兩個路徑疊在一起直接 404。這個坑后面第 5 節(jié)還會單獨展開。4. 驗證請求兩條通道各測一次配置完不要憑感覺按下面兩步各測一次。順序很重要先搜后問這樣出錯時能立刻分清是哪條鏈路的問題。4.1 搜索通道命令行再跑一次gsearch 新加坡天氣看到帶編號的引用條目就算通過。這一步和 Claude Code 完全無關(guān)純命令行通過就意味著 OAuth、網(wǎng)絡(luò)、證書、結(jié)果解析都沒問題。如果這里失敗別去動 Base URL問題不在模型通道。4.2 模型通道回 Claude Code 查一個新文檔啟動 Claude Code問一個明確需要聯(lián)網(wǎng)的問題比如讓它查某個 2026 年才更新的框架文檔并給出引用編號幫我查一下 XXX 框架 2026 年發(fā)布的新版配置格式給出引用編號和原文鏈接正常表現(xiàn)是Claude Code 調(diào)用gsearch把結(jié)果帶進(jìn)上下文然后給出回答并在句末標(biāo)注引用編號。這時你可以順著編號去核對原文驗證的不只是「它能不能搜」而是「它搜到的東西是不是真的」。實測下來這個組合最舒服的地方是回答里能看到引用編號模型有沒有真的去搜一目了然不用猜。如果你還想單獨驗證模型通道是否通可以在模型對話頁面發(fā)一條最簡單的請求https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_gsearch_skillutm_campaignrewrite 。返回正常說明 Key 和額度都沒問題再去查 Claude Code 側(cè)配置。5. 報錯排查Base URL 寫錯是重災(zāi)區(qū)把常見錯誤和現(xiàn)象列成一張表出問題時按行對號入座比盲改配置快得多?，F(xiàn)象大概率原因處理方式Claude Code 報 404 或路徑不存在Base URL 多寫了/v1改回https://taotoken.net/api請求發(fā)出去但認(rèn)證失敗Base URL 帶了官網(wǎng)后綴或查詢參數(shù)只保留域名加/apiSkill 完全沒被觸發(fā)description 寫得過于寬泛收緊觸發(fā)條件只限「最新信息」場景Skill 觸發(fā)但報命令不存在Claude Code 的 PATH 里沒有 gsearch在 Skill 里寫二進(jìn)制絕對路徑命令行能搜Claude Code 里搜不動權(quán)限未放行檢查 Skill 的 allowed-tools 是否包含 Bash(gsearch:*)響應(yīng)突然變慢、額度掉得快搜索結(jié)果回灌過多在 Skill 里限定結(jié)果條數(shù)或縮小查詢范圍5.1 Base URL 的三種錯寫法第一種寫成https://taotoken.net/api/v1。SDK 拼接時會變成/api/v1/v1/...直接 404。第二種把官網(wǎng)首頁地址整段粘過去帶上?utm_source...那一串路徑和參數(shù)全亂請求根本到不了該去的地方。第三種末尾多一個斜杠看起來無害但部分客戶端拼接時會產(chǎn)生雙斜杠某些網(wǎng)關(guān)會判定路徑不匹配。正確的寫法只有一種就是一行export ANTHROPIC_BASE_URLhttps://taotoken.net/api改完記得重新source一次 shell 配置或者干脆開一個新終端窗口。已經(jīng)跑著的 Claude Code 進(jìn)程不會自動讀取新變量這是很多人改完配置「沒生效」的真實原因。5.2 搜索側(cè)的三個小坑第一個坑是憑證文件被覆蓋。如果你同時在用官方 gemini-cli用gsearch --login換賬號可能把本地憑證換成另一個賬號官方 CLI 那邊跟著變。心里要有數(shù)別以為工具壞了。第二個坑是企業(yè)內(nèi)網(wǎng)的自定義根證書場景。gsearch-cli 會自動讀取系統(tǒng)環(huán)境里已有的網(wǎng)絡(luò)配置和證書鏈但如果你手動設(shè)過互相沖突的變量它會讀到錯的那個。排查方式是開一個干凈的 shell 再跑一次gsearch 新加坡天氣對比結(jié)果。第三個坑是查詢詞太寬泛。gsearch Rust回來的東西大概率沒有針對性引用編號看著有但內(nèi)容用不上。把查詢寫成具體的句子比如帶版本號、帶時間范圍結(jié)果質(zhì)量差別很大。6. 通道拆開之后Agent 才算真的能聯(lián)網(wǎng)Skill 路徑和二進(jìn)制配置照著項目自帶的文件抄就行那部分原作者已經(jīng)寫得很細(xì)。真正需要你自己動手的是通道和 Key搜索走 gsearch-cli 的 Gemini OAuth模型調(diào)用走 TaoToken兩條路各管各的出問題時你能一眼看出是哪邊掛了。Key 和通道從這里拿https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_gsearch_skill 創(chuàng)建完直接去 API Keys 頁面復(fù)制https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_gsearch_skillutm_campaignrewrite 。接入細(xì)節(jié)和參數(shù)說明在文檔里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_gsearch_skillutm_campaignrewrite 。如果你不只是想掛搜索還想把 Claude Code 當(dāng)作日常編碼和 Agent 的主力通道長期跑的話看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_gsearch_skillutm_campaignrewrite 。最后給你一個實用習(xí)慣每次改完 Base URL 或 Skill 配置先跑一遍gsearch 新加坡天氣再讓 Claude Code 查一條當(dāng)天的新信息兩次都通過再開始正式干活能省掉大量「到底是哪壞了」的猜測時間。