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