1. 為什么要在 macOS 上養(yǎng)一只 Claude Code 桌面寵物Claude Code 本身是個(gè)命令行工具你敲一句它回一句干完活就安靜地待在那里。但有人把它的源碼翻了個(gè)底朝天發(fā)現(xiàn)里面藏著一套完整的寵物系統(tǒng)彩蛋代號(hào) BUDDY18 種物種、抽卡稀有度、五個(gè)屬性維度、還能戴帽子換眼睛。雖然官方還沒(méi)正式放出來(lái)但社區(qū)已經(jīng)有人等不及了直接做了一個(gè) macOS 原生桌面寵物項(xiàng)目 lil-agents用 Swift 寫的讓一只像素風(fēng)的小家伙在你的 Dock 欄上方走來(lái)走去點(diǎn)一下就能彈出終端跟 Claude Code 對(duì)話。這篇文章要做的就是把這個(gè) Swift 開(kāi)源項(xiàng)目跑起來(lái)并且通過(guò) TaoToken 統(tǒng)一 Key 接入 Claude Code讓你不用折騰多個(gè)賬號(hào)和 API Key一個(gè)通道搞定。適合誰(shuí)手里有 macOS 設(shè)備、裝過(guò) Claude Code、想讓終端工具變得有點(diǎn)溫度的人。我試過(guò)之后發(fā)現(xiàn)整個(gè)流程最麻煩的不是編譯 Swift 項(xiàng)目而是 CLI 那邊的 Key 配置所以這篇會(huì)把重點(diǎn)放在接入配置和驗(yàn)證上。lil-agents 這個(gè)項(xiàng)目的思路很直接它本身不包含 AI 能力只是一個(gè)可視化外殼底層還是調(diào)用你本地裝好的 CLI 進(jìn)程。項(xiàng)目里有兩個(gè)角色Bruce 和 Jazz像素風(fēng)格會(huì)在 Dock 欄上方隨機(jī)走動(dòng)思考時(shí)冒氣泡說(shuō) hmm... 或者 gimme a sec干完活說(shuō) done! 或者 voila!配合 9 種提示音。點(diǎn)一下角色會(huì)彈出終端窗口直接跟 AI 對(duì)話。支持 Claude Code、OpenAI Codex、GitHub Copilot CLI社區(qū)還加了 Gemini 支持。關(guān)鍵點(diǎn)在于它調(diào)用的是你本地的 claude 命令行工具所以只要你的 Claude Code 能正常工作桌面寵物就能正常工作。而 Claude Code 的接入方式可以通過(guò) TaoToken 統(tǒng)一 Key 來(lái)配置這樣你不需要在多個(gè)地方管理不同的 API Key。整個(gè)鏈路是這樣的lil-agentsSwift 桌面應(yīng)用→ 調(diào)用本地 claude CLI → claude CLI 讀取環(huán)境變量或配置文件 → 請(qǐng)求發(fā)到 TaoToken 的 API 通道 → 返回結(jié)果 → 寵物顯示氣泡和動(dòng)畫。所以配置的核心就兩件事第一讓 claude CLI 能通過(guò) TaoToken 正常請(qǐng)求第二讓 lil-agents 能找到你的 claude CLI。第一件事是重點(diǎn)第二件事基本是開(kāi)箱即用。2. TaoToken 統(tǒng)一 Key 的前置準(zhǔn)備與 Claude Code 接入配置在開(kāi)始之前你需要先拿到 TaoToken 的 API Key。打開(kāi) https://taotoken.net/api-keys 這個(gè)地址注冊(cè)或登錄后創(chuàng)建一個(gè)新的 Key。創(chuàng)建的時(shí)候注意復(fù)制下來(lái)因?yàn)轫?yè)面刷新后就不會(huì)再完整顯示了。拿到 Key 之后你需要確認(rèn)兩件事Base URL 和 Model ID。TaoToken 的 API 地址是 https://taotoken.net/api這個(gè)地址不加任何 UTM 參數(shù)直接用在配置里。Model ID 方面Claude Code 場(chǎng)景下常用的模型標(biāo)識(shí)你可以在 https://taotoken.net/doc 的文檔頁(yè)面查到最新的列表一般用 claude-sonnet 系列就能滿足日常編碼對(duì)話需求。接下來(lái)是配置 Claude Code 讀取這個(gè) Key。Claude Code 支持通過(guò)環(huán)境變量或者配置文件來(lái)指定 API 端點(diǎn)。最直接的方式是在你的 shell 配置文件里加環(huán)境變量。打開(kāi)終端編輯 ~/.zshrc如果你用的是 zsh或者 ~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密鑰保存后執(zhí)行 source ~/.zshrc 讓配置生效。這里要注意ANTHROPIC_BASE_URL 的值就是 TaoToken 的 API 地址不要加多余的路徑后綴。ANTHROPIC_API_KEY 填你剛才復(fù)制的 Key。如果你不想改環(huán)境變量也可以用 Claude Code 的配置文件方式。在 ~/.claude/ 目錄下創(chuàng)建或編輯 settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密鑰 } }這個(gè) settings.json 的路徑是 ~/.claude/settings.json如果你之前沒(méi)有這個(gè)文件直接新建就行。JSON 格式要嚴(yán)格最后一個(gè)字段后面不能有逗號(hào)。配置完成后你可以先用 claude 命令行工具驗(yàn)證一下。在終端里直接運(yùn)行claude -p 你好請(qǐng)回復(fù)一句話如果配置正確你會(huì)看到 Claude 的回復(fù)。如果報(bào)錯(cuò)先檢查 Key 是否復(fù)制完整、Base URL 是否有多余空格。這一步是整個(gè)鏈路的基礎(chǔ)CLI 不通桌面寵物也不會(huì)通。另外提一下如果你同時(shí)用 Codex 或者 Copilot CLI它們的配置方式類似但環(huán)境變量名不同。Codex 用的是 OPENAI_API_KEY 和 OPENAI_BASE_URLCopilot CLI 有自己的配置文件。不過(guò)這篇聚焦 Claude Code其他的你可以在 TaoToken 文檔里找到對(duì)應(yīng)說(shuō)明。3. lil-agents 項(xiàng)目克隆與 Swift 編譯運(yùn)行步驟前置配置搞定后接下來(lái)把 lil-agents 跑起來(lái)。這個(gè)項(xiàng)目是 Swift 寫的原生 macOS 應(yīng)用你需要先確認(rèn)本地有 Xcode 或者至少裝了 Swift 命令行工具。在終端里運(yùn)行 swift --version如果能輸出版本號(hào)就說(shuō)明環(huán)境沒(méi)問(wèn)題。如果沒(méi)有去 App Store 裝一個(gè) Xcode或者用 xcode-select --install 安裝命令行工具。第一步克隆項(xiàng)目。打開(kāi)終端找一個(gè)你放代碼的目錄cd ~/Projects git clone https://github.com/ryanstephen/lil-agents.git cd lil-agents第二步查看項(xiàng)目結(jié)構(gòu)。這個(gè)項(xiàng)目用的是 Swift Package Manager 或者 Xcode 項(xiàng)目具體取決于倉(cāng)庫(kù)的當(dāng)前狀態(tài)。你可以先 ls 看一下ls -la如果看到 Package.swift說(shuō)明是 SPM 項(xiàng)目直接用命令行編譯swift build -c release如果看到 .xcodeproj 或者 .xcworkspace那就用 xcodebuild 編譯xcodebuild -project lil-agents.xcodeproj -scheme lil-agents -configuration Release build編譯過(guò)程可能需要幾分鐘取決于你的機(jī)器性能。編譯完成后產(chǎn)物會(huì)在 .build/release/ 或者 DerivedData 目錄下。你也可以直接用 Xcode 打開(kāi)項(xiàng)目按 CmdR 運(yùn)行。第三步運(yùn)行應(yīng)用。如果編譯成功你會(huì)看到 Dock 欄上方出現(xiàn)一個(gè)像素風(fēng)的小角色可能是 Bruce 也可能是 Jazz。它會(huì)隨機(jī)走動(dòng)偶爾冒個(gè)氣泡。點(diǎn)一下它會(huì)彈出一個(gè)終端窗口。這里有個(gè)關(guān)鍵點(diǎn)lil-agents 調(diào)用的是你本地 PATH 里的 claude 命令。所以你要確保 claude 在 PATH 中可用。在終端里運(yùn)行 which claude如果輸出類似 /usr/local/bin/claude 或者 /opt/homebrew/bin/claude就說(shuō)明沒(méi)問(wèn)題。如果沒(méi)有輸出你需要把 claude 的安裝路徑加到 PATH 里或者用絕對(duì)路徑配置 lil-agents。lil-agents 的設(shè)置里可以指定 CLI 路徑。打開(kāi)應(yīng)用的偏好設(shè)置找到 CLI Path 這一項(xiàng)填入你的 claude 絕對(duì)路徑。這樣即使 PATH 有問(wèn)題它也能找到。另外這個(gè)項(xiàng)目支持多套主題你可以在設(shè)置里切換。角色動(dòng)畫用的是透明 HEVC 視頻無(wú)縫循環(huán)播放Dock 欄位置是動(dòng)態(tài)計(jì)算的能識(shí)別自動(dòng)隱藏、全屏、多顯示器這些場(chǎng)景。整個(gè)應(yīng)用完全本地運(yùn)行不收集任何數(shù)據(jù)所有對(duì)話都走你本地裝好的 CLI 進(jìn)程。如果你在編譯過(guò)程中遇到簽名問(wèn)題可以在 Xcode 里把 Signing Capabilities 里的 Team 設(shè)置成你的開(kāi)發(fā)者賬號(hào)或者選擇 Sign to Run Locally。如果是 SPM 編譯一般不會(huì)有簽名問(wèn)題。4. 驗(yàn)證桌面寵物響應(yīng)與 Claude Code 對(duì)話鏈路應(yīng)用跑起來(lái)后你需要驗(yàn)證整條鏈路是否通暢。驗(yàn)證分兩步先確認(rèn) CLI 本身能通再確認(rèn)桌面寵物能調(diào)用 CLI。第一步在終端里直接測(cè)試 claude 命令claude -p 用一句話介紹你自己如果返回了正常的文本說(shuō)明 TaoToken 的 Key 配置沒(méi)問(wèn)題。如果報(bào) 401說(shuō)明 Key 無(wú)效或者沒(méi)生效如果報(bào)連接超時(shí)檢查 Base URL 是否正確。第二步點(diǎn)擊桌面上的寵物角色彈出終端窗口。在窗口里輸入一句話比如“幫我寫一個(gè) Python 的 hello world”。觀察寵物的反應(yīng)它應(yīng)該會(huì)冒出一個(gè)思考?xì)馀菡f(shuō) hmm... 或者 gimme a sec然后過(guò)幾秒返回結(jié)果氣泡變成 done! 或者 voila!。如果寵物沒(méi)有反應(yīng)先檢查 lil-agents 的設(shè)置里 CLI Path 是否指向了正確的 claude 路徑。你可以在終端里用 which claude 拿到路徑然后填進(jìn)去。第三步驗(yàn)證多輪對(duì)話。在寵物彈出的終端窗口里連續(xù)輸入幾句話看它是否能保持上下文。Claude Code 本身支持多輪對(duì)話lil-agents 只是把終端窗口嵌到了應(yīng)用里所以上下文應(yīng)該能正常保持。如果一切正常你會(huì)看到寵物在 Dock 欄上方走來(lái)走去點(diǎn)一下就能干活干完活還會(huì)給你個(gè)反饋。這種體驗(yàn)比在終端里敲命令有趣多了。這里補(bǔ)充一個(gè)細(xì)節(jié)lil-agents 的寵物動(dòng)畫狀態(tài)和 CLI 的執(zhí)行狀態(tài)是綁定的。當(dāng) CLI 在思考時(shí)寵物會(huì)顯示思考動(dòng)畫當(dāng) CLI 返回結(jié)果時(shí)寵物會(huì)顯示完成動(dòng)畫。所以如果你看到寵物一直在思考狀態(tài)不結(jié)束說(shuō)明 CLI 那邊卡住了可能是網(wǎng)絡(luò)問(wèn)題或者 Key 配額問(wèn)題。你可以打開(kāi) Console.app 查看 lil-agents 的日志過(guò)濾進(jìn)程名就能看到它調(diào)用 CLI 的詳細(xì)輸出。如果 CLI 報(bào)錯(cuò)日志里會(huì)有記錄。5. 常見(jiàn)報(bào)錯(cuò)排查與配置對(duì)照這一節(jié)列出幾個(gè)我踩過(guò)的坑和對(duì)應(yīng)的排查方法。報(bào)錯(cuò)一401 Unauthorized。這個(gè)最常見(jiàn)說(shuō)明 API Key 無(wú)效或者沒(méi)被正確讀取。排查步驟先在終端里運(yùn)行 echo $ANTHROPIC_API_KEY看是否輸出了你的 Key。如果沒(méi)有輸出說(shuō)明環(huán)境變量沒(méi)生效檢查 ~/.zshrc 是否 source 了。如果輸出了但仍然是 401檢查 Key 是否復(fù)制完整有沒(méi)有多余的空格或換行。另外確認(rèn) Base URL 是 https://taotoken.net/api不要寫成其他路徑。報(bào)錯(cuò)二local proxy failed 或 connection refused。這個(gè)通常是因?yàn)?Base URL 配置錯(cuò)誤或者本地網(wǎng)絡(luò)無(wú)法訪問(wèn) TaoToken 的 API 地址。先檢查 ANTHROPIC_BASE_URL 的值確保沒(méi)有多余字符。然后在終端里用 curl 測(cè)試一下curl -I https://taotoken.net/api如果返回 200 或 401 都說(shuō)明網(wǎng)絡(luò)通如果超時(shí)就是網(wǎng)絡(luò)問(wèn)題。報(bào)錯(cuò)三reading choices 相關(guān)錯(cuò)誤。這個(gè)一般出現(xiàn)在流式響應(yīng)解析時(shí)可能是 Model ID 不匹配。檢查你配置的模型標(biāo)識(shí)是否在 TaoToken 文檔的支持列表里。Claude Code 默認(rèn)會(huì)用某個(gè)模型你可以在 settings.json 里顯式指定{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密鑰, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }Model ID 的具體值以 TaoToken 文檔為準(zhǔn)不同時(shí)間可能有更新。報(bào)錯(cuò)四OAuth 相關(guān)錯(cuò)誤。Claude Code 某些版本會(huì)嘗試 OAuth 登錄如果你用的是 API Key 模式需要確保沒(méi)有殘留的 OAuth token。檢查 ~/.claude/ 目錄下是否有 credentials.json 之類的文件如果有先備份再刪除然后重新用 API Key 配置。報(bào)錯(cuò)五lil-agents 找不到 claude 命令。這個(gè)不是 API 問(wèn)題是 PATH 問(wèn)題。在 lil-agents 設(shè)置里手動(dòng)指定 CLI 絕對(duì)路徑即可。你可以在終端里用 which claude 拿到路徑。報(bào)錯(cuò)六編譯時(shí)提示 Swift 版本不兼容。檢查 Package.swift 里的 swift-tools-version如果你的 Swift 版本太低升級(jí) Xcode 或者用 swiftenv 管理多版本。為了讓你更清楚各個(gè)配置項(xiàng)的作用這里用一個(gè)表格對(duì)照配置項(xiàng)作用推薦值A(chǔ)NTHROPIC_BASE_URLAPI 請(qǐng)求地址https://taotoken.net/apiANTHROPIC_API_KEY身份認(rèn)證密鑰sk-你的TaoToken密鑰ANTHROPIC_MODEL指定模型以文檔為準(zhǔn)CLI Pathlil-agents 調(diào)用路徑which claude 的輸出排查的時(shí)候按順序來(lái)先確認(rèn) CLI 能通再確認(rèn)寵物能調(diào)用 CLI最后確認(rèn)對(duì)話能返回結(jié)果。每一步都單獨(dú)驗(yàn)證不要跳步。6. 長(zhǎng)期使用建議與接入文檔參考桌面寵物跑起來(lái)之后你可能會(huì)想長(zhǎng)期用它。這里給幾個(gè)實(shí)用建議。第一把 claude 命令的別名配好。如果你經(jīng)常用 Claude Code可以在 ~/.zshrc 里加一個(gè) alias比如 alias ccclaude這樣在寵物終端里輸入更短。第二定期檢查 TaoToken 的 Key 配額和有效期。在 https://taotoken.net/console 可以看到你的使用情況。如果 Key 快到期了提前換一個(gè)新的然后更新環(huán)境變量。第三如果你同時(shí)用多個(gè) CLI 工具比如 Claude Code 和 Codex可以用 TaoToken 的統(tǒng)一 Key 管理。每個(gè)工具的環(huán)境變量名不同但 Key 可以是同一個(gè)。具體配置參考 https://taotoken.net/doc 里的多工具接入說(shuō)明。第四lil-agents 的項(xiàng)目地址是 https://github.com/ryanstephen/lil-agents你可以關(guān)注它的更新。社區(qū)也在加新功能比如更多角色、更多主題、更多 CLI 支持。第五如果你想讓寵物在特定場(chǎng)景下觸發(fā)特定動(dòng)作可以看 lil-agents 的源碼里動(dòng)畫狀態(tài)機(jī)的部分。它根據(jù) CLI 的輸出狀態(tài)切換動(dòng)畫你可以擴(kuò)展這個(gè)邏輯。最后如果你在配置過(guò)程中遇到問(wèn)題優(yōu)先看 TaoToken 的接入文檔里面有針對(duì) Claude Code 的詳細(xì)說(shuō)明。文檔地址是 https://taotoken.net/doc。如果文檔里沒(méi)有覆蓋你的場(chǎng)景可以在 console 里提交工單。整個(gè)流程的核心就是TaoToken 提供統(tǒng)一的 API 通道Claude Code 通過(guò)環(huán)境變量或配置文件接入lil-agents 作為可視化外殼調(diào)用本地 CLI。三層各司其職配置一次就能長(zhǎng)期用。桌面寵物這個(gè)玩法雖然看起來(lái)是個(gè)小創(chuàng)意但它把冷冰冰的命令行工具變成了有反饋的交互對(duì)象用起來(lái)確實(shí)比純終端舒服。