1. 從superpowers這個(gè)詞說起它到底指什么第一次看到superpowers這個(gè)項(xiàng)目名很多人會(huì)以為是某個(gè)超級(jí)英雄題材的游戲或者娛樂項(xiàng)目。但結(jié)合熱搜詞里的agentic skills framework、software development methodology、Claude Code、Codex CLI這些關(guān)鍵詞方向就很清楚了——這是一個(gè)圍繞智能體技能框架和軟件開發(fā)方法論的項(xiàng)目核心是讓 AI 編程助手真正具備超能力從只會(huì)補(bǔ)全代碼的工具變成能獨(dú)立完成復(fù)雜開發(fā)任務(wù)的協(xié)作伙伴。我自己是從去年開始深度使用 Claude Code 和 Codex CLI 這類終端智能體工具的一路踩坑過來最大的感受是工具本身的能力上限和你能不能把它用出超能力完全是兩回事。同一個(gè) Claude Code有人用它寫個(gè)正則都費(fèi)勁有人能靠它一天重構(gòu)完一個(gè)模塊。差距不在模型在于你有沒有一套成體系的方法論——這恰恰就是 superpowers 這個(gè)項(xiàng)目想解決的問題。這篇文章我會(huì)從三個(gè)層面展開第一superpowers 這類 agentic skills framework 到底在解決什么真實(shí)痛點(diǎn)第二Claude Code 和 Codex CLI 這兩個(gè)主流終端智能體的安裝、配置、核心命令和實(shí)戰(zhàn)技巧第三怎么把零散的工具使用經(jīng)驗(yàn)沉淀成一套可復(fù)用的技能框架讓 AI 真正成為你的開發(fā)超能力。不管你是剛聽說 Claude Code 的新手還是已經(jīng)用了一段時(shí)間但總覺得沒發(fā)揮出全部實(shí)力的老用戶應(yīng)該都能從里面找到能直接抄作業(yè)的東西。提示本文涉及的安裝配置以 macOS 和 Ubuntu 為主Windows 用戶建議優(yōu)先考慮 WSL2 環(huán)境后面會(huì)專門講原因。2. 為什么會(huì)用工具和用出超能力是兩碼事2.1 大多數(shù)人對(duì) AI 編程助手的用法還停留在高級(jí)補(bǔ)全我觀察過身邊不少開發(fā)者用 Claude Code 的方式打開終端敲一句幫我寫個(gè)函數(shù)拿到代碼復(fù)制粘貼結(jié)束。這種用法不能說錯(cuò)但相當(dāng)于你買了一臺(tái)專業(yè)單反全程只用自動(dòng)模式拍。AI 編程助手真正的價(jià)值不在于它能生成多少行代碼而在于它能理解上下文、執(zhí)行多步任務(wù)、調(diào)用工具鏈、自我驗(yàn)證結(jié)果——這些能力組合起來才叫 agentic智能體化。普通補(bǔ)全工具的工作模式是你寫一半它猜一半而 Claude Code 這類終端智能體的工作模式是你描述目標(biāo)它規(guī)劃步驟、執(zhí)行命令、讀取文件、修改代碼、跑測試、根據(jù)報(bào)錯(cuò)再調(diào)整。這個(gè)循環(huán)一旦跑通你面對(duì)的就不是一個(gè)代碼生成器而是一個(gè)能獨(dú)立干活的初級(jí)工程師。superpowers 這個(gè)項(xiàng)目名里的超能力我理解就是指這種從工具到協(xié)作者的躍遷。2.2 技能框架解決的三個(gè)核心痛點(diǎn)為什么需要一套技能框架而不是零散技巧因?yàn)閷?shí)際開發(fā)中會(huì)遇到三類反復(fù)出現(xiàn)的問題第一類是上下文丟失。你讓 AI 改一個(gè)函數(shù)它改完了但不知道這個(gè)函數(shù)被哪些地方調(diào)用改完就引入 bug。技能框架會(huì)強(qiáng)制你在任務(wù)開始前先做影響面分析把相關(guān)文件、調(diào)用鏈、測試用例一起喂給 AI。第二類是任務(wù)粒度失控。一句幫我重構(gòu)這個(gè)項(xiàng)目扔過去AI 要么無從下手要么大刀闊斧改得面目全非。好的方法論會(huì)把大任務(wù)拆成可驗(yàn)證的小步驟每步都有明確的輸入輸出和驗(yàn)收標(biāo)準(zhǔn)。第三類是經(jīng)驗(yàn)無法沉淀。這次調(diào)通了某個(gè)配置下次換個(gè)項(xiàng)目又得重新摸索。技能框架的本質(zhì)就是把這些調(diào)通了的路徑固化成可復(fù)用的模板和檢查清單。2.3 一個(gè)真實(shí)對(duì)比有框架和沒框架的差距我拿同一個(gè)任務(wù)做過對(duì)比——給一個(gè)中等規(guī)模的 Node.js 項(xiàng)目加一個(gè)帶緩存的 API 接口。沒有框架時(shí)我的操作是直接讓 Claude Code 寫接口代碼它寫完了我手動(dòng)去改路由、加緩存依賴、跑測試來回折騰了七八輪中間還因?yàn)闆]告訴它項(xiàng)目的緩存庫用的是哪個(gè)它默認(rèn)用了內(nèi)存緩存而項(xiàng)目實(shí)際用的是 Redis。有框架時(shí)我先做三件事把項(xiàng)目的package.json、路由目錄結(jié)構(gòu)、已有的緩存封裝文件一起讀進(jìn)來明確告訴它緩存必須復(fù)用src/utils/cache.js里的封裝要求它先輸出改動(dòng)計(jì)劃再動(dòng)手。結(jié)果它一次性給出了正確的實(shí)現(xiàn)我只做了微調(diào)。差距不在模型能力在于你有沒有在任務(wù)開始前把約束條件和驗(yàn)收標(biāo)準(zhǔn)講清楚。這就是技能框架的價(jià)值。3. Claude Code 從零到跑通安裝、配置與第一個(gè)任務(wù)3.1 安裝前的環(huán)境準(zhǔn)備別跳過這一步Claude Code 官方推薦 Node.js 18 以上版本。我見過太多人卡在安裝環(huán)節(jié)八成是 Node 版本太老或者 npm 權(quán)限有問題。先確認(rèn)環(huán)境node -v npm -v如果 Node 版本低于 18建議用 nvm 管理版本別直接升級(jí)系統(tǒng) Node容易把其他依賴搞崩# 安裝 nvmmacOS/Linux curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash # 重新加載 shell 配置后 nvm install 20 nvm use 20Windows 用戶這里要特別注意Claude Code 在原生 Windows 環(huán)境下兼容性問題比較多熱搜詞里那條由于與64位版本的windows不兼容就是典型癥狀。最穩(wěn)的方案是裝 WSL2在 Ubuntu 子系統(tǒng)里跑體驗(yàn)和 Linux 幾乎一致。3.2 安裝 Claude Code 與首次登錄環(huán)境就緒后安裝本身很簡單npm install -g anthropic-ai/claude-code裝完驗(yàn)證一下claude --version首次運(yùn)行claude會(huì)引導(dǎo)你登錄。這里有個(gè)常見困惑注冊(cè)賬號(hào)和不注冊(cè)有什么區(qū)別簡單說登錄賬號(hào)后你用的是官方訂閱額度能享受完整的模型能力和更新不登錄的話部分功能會(huì)受限而且沒法用一些需要身份校驗(yàn)的高級(jí)特性。如果你所在地區(qū)提示might not be available in your country那屬于服務(wù)可用性限制這種情況可以考慮通過第三方 API 接入的方式使用其他模型后面會(huì)講。3.3 VS Code 里配置 Claude Code插件還是終端很多人糾結(jié)要不要裝 VS Code 插件。我的建議是兩個(gè)都用但分工明確。VS Code 插件的優(yōu)勢是能直接讀取編輯器里的當(dāng)前文件和選區(qū)適合針對(duì)某段代碼做局部修改的場景。終端版 Claude Code 的優(yōu)勢是能執(zhí)行命令、跑測試、操作文件系統(tǒng)適合完成一個(gè)完整任務(wù)的場景。插件配置的關(guān)鍵點(diǎn)在于確保插件能找到你的 Claude Code 可執(zhí)行文件路徑。如果插件報(bào)找不到 claude 命令在插件設(shè)置里手動(dòng)指定路徑通常是which claude # 輸出類似 /usr/local/bin/claude把這個(gè)路徑填進(jìn)插件配置3.4 用 CC Switch 接入第三方模型DeepSeek、Qwen、GLM 怎么選這是熱搜里問得最多的一塊。Claude Code 默認(rèn)走官方模型但通過 CC Switch 這類工具可以把它接到 DeepSeek、Qwen、GLM 等第三方模型上。為什么有人要這么做兩個(gè)原因一是成本二是某些模型在特定任務(wù)上表現(xiàn)更好。配置思路是CC Switch 負(fù)責(zé)管理不同模型的 API 端點(diǎn)和密鑰Claude Code 通過環(huán)境變量指向 CC Switch 提供的本地代理地址。大致流程# 設(shè)置 API 基礎(chǔ)地址指向本地代理 export ANTHROPIC_BASE_URLhttp://localhost:你的端口 export ANTHROPIC_API_KEY你的密鑰選模型的實(shí)戰(zhàn)經(jīng)驗(yàn)DeepSeek 在代碼生成和邏輯推理上性價(jià)比很高適合日常開發(fā)Qwen 在中文語境理解和長文本處理上有優(yōu)勢GLM 在工具調(diào)用和結(jié)構(gòu)化輸出上比較穩(wěn)。我的做法是日常任務(wù)用 DeepSeek遇到需要大量中文文檔理解的任務(wù)切 Qwen需要 AI 頻繁調(diào)用工具鏈時(shí)用 GLM。切換成本很低值得按任務(wù)類型靈活選。注意第三方模型的工具調(diào)用能力參差不齊如果發(fā)現(xiàn) AI 不執(zhí)行命令、不讀文件先檢查模型是否支持 function calling這是終端智能體的命脈。4. Codex CLI 的核心命令與實(shí)戰(zhàn)用法4.1 Codex CLI 和 Claude Code 的定位差異Codex CLI 是另一條技術(shù)路線。如果說 Claude Code 更像全能型協(xié)作者Codex CLI 則更偏向命令行里的精準(zhǔn)執(zhí)行者。它的命令設(shè)計(jì)更貼近傳統(tǒng) CLI 工具的習(xí)慣適合已經(jīng)熟悉終端操作、想要快速完成特定任務(wù)的開發(fā)者。安裝同樣基于 npmnpm install -g openai/codex裝完直接codex啟動(dòng)。它的交互模式和 Claude Code 類似都是對(duì)話式但命令體系有自己的特點(diǎn)。4.2 那幾個(gè)必須記住的斜杠命令熱搜里專門問了codex cli 命令哪些我挑幾個(gè)高頻的講透/compact—— 這個(gè)命令的作用是壓縮對(duì)話歷史。終端智能體跑久了上下文會(huì)越來越長既費(fèi) token 又拖慢響應(yīng)。/compact會(huì)把之前的對(duì)話總結(jié)成精簡版本保留關(guān)鍵信息丟掉冗余。我的習(xí)慣是每完成一個(gè)子任務(wù)就 compact 一次保持上下文清爽。/model—— 切換當(dāng)前使用的模型。不同任務(wù)用不同模型是常態(tài)比如寫代碼用強(qiáng)推理模型寫文檔用長文本模型一條命令切換不用重啟。/resume—— 恢復(fù)之前的會(huì)話。這個(gè)太重要了。終端關(guān)了、電腦重啟了之前的上下文還在/resume一下接著干。我經(jīng)常一個(gè)復(fù)雜任務(wù)分幾天做全靠這個(gè)命令續(xù)上。刪除指令—— 熱搜里提到刪除 codex cli 指令指的是清理不再需要的會(huì)話記錄或配置。具體命令隨版本變化建議用codex --help查當(dāng)前版本的準(zhǔn)確用法別照搬網(wǎng)上的老教程。4.3 Codex CLI 配合 Remotion 做視頻生成熱搜里有個(gè)很有意思的組合codex cli remotion。Remotion 是一個(gè)用 React 寫視頻的框架而 Codex CLI 可以幫你生成和調(diào)試 Remotion 代碼。這個(gè)組合的價(jià)值在于視頻這種通常需要可視化編輯的東西現(xiàn)在可以用代碼描述而 AI 能幫你寫代碼。實(shí)操思路是先用自然語言描述你想要的視頻效果比如一個(gè)文字從左滑入、停留兩秒、再淡出的開場讓 Codex CLI 生成對(duì)應(yīng)的 Remotion 組件代碼然后本地渲染預(yù)覽根據(jù)效果再調(diào)整。這個(gè)流程把視頻制作變成了代碼迭代對(duì)程序員來說反而更順手。4.4 命令速查表命令作用使用場景/compact壓縮對(duì)話歷史上下文過長、響應(yīng)變慢時(shí)/model切換模型不同任務(wù)需要不同模型時(shí)/resume恢復(fù)歷史會(huì)話中斷后繼續(xù)之前的任務(wù)--help查看所有命令不確定命令用法時(shí)5. 把工具用成超能力一套可復(fù)用的技能框架5.1 任務(wù)開始前的三件套準(zhǔn)備這是我用得最順的一套開場流程每次新任務(wù)都走一遍第一喂上下文。把相關(guān)的目錄結(jié)構(gòu)、關(guān)鍵文件、配置文件一次性讀進(jìn)來。別指望 AI 自己猜它猜不準(zhǔn)。第二定約束。明確告訴它必須用什么庫不能改哪些文件代碼風(fēng)格遵循什么規(guī)范。約束越清晰返工越少。第三要計(jì)劃。讓它先輸出改動(dòng)計(jì)劃你確認(rèn)后再動(dòng)手。這一步能攔掉大部分方向性錯(cuò)誤。5.2 讓 AI 直接執(zhí)行終端命令的正確姿勢Claude Code 能直接執(zhí)行終端命令這是它區(qū)別于普通補(bǔ)全工具的核心能力。但很多人不敢用怕它亂執(zhí)行。我的經(jīng)驗(yàn)是給它執(zhí)行權(quán)限但要求它先說明再執(zhí)行。具體做法是在提示里加一句執(zhí)行任何命令前先用一句話說明這條命令的作用和預(yù)期結(jié)果。這樣你既享受了自動(dòng)化又保留了監(jiān)督權(quán)。遇到危險(xiǎn)命令比如rm -rf它會(huì)先告訴你你有機(jī)會(huì)喊停。5.3 本地模型接入LM Studio 的玩法熱搜里問claude code 調(diào)用 lmstudio 的本地模型這是個(gè)進(jìn)階玩法。LM Studio 能在本地跑開源模型通過它提供的本地 API 端點(diǎn)可以讓 Claude Code 走本地模型。好處是數(shù)據(jù)不出本機(jī)、零 API 成本代價(jià)是本地模型的能力通常弱于云端大模型適合對(duì)隱私敏感或純離線場景。配置核心還是環(huán)境變量指向 LM Studio 的本地地址export ANTHROPIC_BASE_URLhttp://localhost:1234/v1 export ANTHROPIC_API_KEYlm-studio提示本地模型對(duì)工具調(diào)用的支持差異很大接入后先跑個(gè)簡單任務(wù)驗(yàn)證它能不能正確讀文件、執(zhí)行命令再投入正式使用。5.4 飛書等協(xié)作工具怎么和 Claude Code 打通飛書如何連接 claude code這類需求本質(zhì)是想讓 AI 能力進(jìn)入團(tuán)隊(duì)協(xié)作流。常見做法是寫一個(gè)中間服務(wù)飛書機(jī)器人收到消息后轉(zhuǎn)發(fā)給 Claude Code 的接口把結(jié)果回傳。這不是開箱即用的功能需要一點(diǎn)開發(fā)工作但思路很清晰——把 Claude Code 當(dāng)成一個(gè)可編程的能力后端前端接什么飛書、Slack、自建網(wǎng)頁都行。6. 踩過的坑和幾條保命經(jīng)驗(yàn)6.1 環(huán)境類坑Windows 兼容性和權(quán)限問題前面提過 Windows 原生環(huán)境的兼容性問題這里再強(qiáng)調(diào)一次能上 WSL2 就上 WSL2。我見過太多人在 Windows 上折騰半天最后換到 WSL2 十分鐘搞定。另外 npm 全局安裝如果報(bào)權(quán)限錯(cuò)誤別用sudo硬來配置一下 npm 的全局目錄更干凈mkdir ~/.npm-global npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATH6.2 賬號(hào)類坑訂閱訪問被禁用怎么辦熱搜里那條your organization has disabled claude subscription access是團(tuán)隊(duì)賬號(hào)常見問題。遇到這個(gè)先確認(rèn)是不是組織管理員關(guān)閉了相關(guān)權(quán)限這是賬號(hào)策略問題不是技術(shù)問題。如果是個(gè)人使用遇到地區(qū)限制那就走第三方 API 接入的路子前面講過配置方法。6.3 使用類坑別讓 AI 一次改太多這是我最想強(qiáng)調(diào)的一條經(jīng)驗(yàn)。AI 一次改動(dòng)的文件越多出錯(cuò)的概率越高而且出錯(cuò)后越難定位。我的鐵律是一個(gè)任務(wù)最多涉及三到五個(gè)文件超過就拆。寧可多輪小改動(dòng)不要一輪大重構(gòu)。大重構(gòu)看起來爽但一旦引入隱蔽 bug排查成本遠(yuǎn)超你省下的時(shí)間。6.4 上下文類坑什么時(shí)候該 compact判斷標(biāo)準(zhǔn)很簡單當(dāng)你發(fā)現(xiàn) AI 開始忘記前面說過的約束或者響應(yīng)明顯變慢時(shí)就該 compact 了。別等到它徹底跑偏才處理。我一般每完成一個(gè)獨(dú)立子任務(wù)就 compact 一次保持上下文始終聚焦在當(dāng)前任務(wù)上。7. 關(guān)于超能力這件事我的一點(diǎn)真實(shí)體會(huì)用了大半年 Claude Code 和 Codex CLI我最大的轉(zhuǎn)變不是寫代碼變快了而是思考任務(wù)的方式變了。以前拿到需求直接開寫現(xiàn)在會(huì)先想這個(gè)任務(wù)的邊界在哪、約束是什么、怎么拆成可驗(yàn)證的步驟、哪些部分可以交給 AI。這套思維方式其實(shí)和帶一個(gè)真人團(tuán)隊(duì)是一樣的——你得會(huì)拆解、會(huì)溝通、會(huì)驗(yàn)收。superpowers 這個(gè)項(xiàng)目名起得挺準(zhǔn)。AI 編程助手本身沒有超能力它是一面鏡子照出的是你組織任務(wù)、表達(dá)需求、把控質(zhì)量的能力。你把方法論理順了它就是超能力你只會(huì)甩一句幫我寫代碼它就是個(gè)高級(jí)補(bǔ)全。工具是死的框架是活的真正值錢的是那套把工具用出花來的經(jīng)驗(yàn)。如果你剛開始接觸我的建議是別貪多先把 Claude Code 裝起來跑通一個(gè)真實(shí)的小任務(wù)把喂上下文、定約束、要計(jì)劃這三步走順。等你對(duì)它的脾氣摸熟了再考慮接第三方模型、接本地模型、接協(xié)作工具這些進(jìn)階玩法。一步一步來比一上來就搭一套復(fù)雜框架要靠譜得多。