1. 从superpowers这个词说起它到底指什么第一次看到superpowers这个项目名很多人会以为是某个超级英雄题材的游戏或者娱乐项目。但结合热搜词里的agentic skills framework、software development methodology、Claude Code、Codex CLI这些关键词方向就很清楚了——这是一个围绕智能体技能框架和软件开发方法论的项目核心是让 AI 编程助手真正具备超能力从只会补全代码的工具变成能独立完成复杂开发任务的协作伙伴。我自己是从去年开始深度使用 Claude Code 和 Codex CLI 这类终端智能体工具的一路踩坑过来最大的感受是工具本身的能力上限和你能不能把它用出超能力完全是两回事。同一个 Claude Code有人用它写个正则都费劲有人能靠它一天重构完一个模块。差距不在模型在于你有没有一套成体系的方法论——这恰恰就是 superpowers 这个项目想解决的问题。这篇文章我会从三个层面展开第一superpowers 这类 agentic skills framework 到底在解决什么真实痛点第二Claude Code 和 Codex CLI 这两个主流终端智能体的安装、配置、核心命令和实战技巧第三怎么把零散的工具使用经验沉淀成一套可复用的技能框架让 AI 真正成为你的开发超能力。不管你是刚听说 Claude Code 的新手还是已经用了一段时间但总觉得没发挥出全部实力的老用户应该都能从里面找到能直接抄作业的东西。提示本文涉及的安装配置以 macOS 和 Ubuntu 为主Windows 用户建议优先考虑 WSL2 环境后面会专门讲原因。2. 为什么会用工具和用出超能力是两码事2.1 大多数人对 AI 编程助手的用法还停留在高级补全我观察过身边不少开发者用 Claude Code 的方式打开终端敲一句帮我写个函数拿到代码复制粘贴结束。这种用法不能说错但相当于你买了一台专业单反全程只用自动模式拍。AI 编程助手真正的价值不在于它能生成多少行代码而在于它能理解上下文、执行多步任务、调用工具链、自我验证结果——这些能力组合起来才叫 agentic智能体化。普通补全工具的工作模式是你写一半它猜一半而 Claude Code 这类终端智能体的工作模式是你描述目标它规划步骤、执行命令、读取文件、修改代码、跑测试、根据报错再调整。这个循环一旦跑通你面对的就不是一个代码生成器而是一个能独立干活的初级工程师。superpowers 这个项目名里的超能力我理解就是指这种从工具到协作者的跃迁。2.2 技能框架解决的三个核心痛点为什么需要一套技能框架而不是零散技巧因为实际开发中会遇到三类反复出现的问题第一类是上下文丢失。你让 AI 改一个函数它改完了但不知道这个函数被哪些地方调用改完就引入 bug。技能框架会强制你在任务开始前先做影响面分析把相关文件、调用链、测试用例一起喂给 AI。第二类是任务粒度失控。一句帮我重构这个项目扔过去AI 要么无从下手要么大刀阔斧改得面目全非。好的方法论会把大任务拆成可验证的小步骤每步都有明确的输入输出和验收标准。第三类是经验无法沉淀。这次调通了某个配置下次换个项目又得重新摸索。技能框架的本质就是把这些调通了的路径固化成可复用的模板和检查清单。2.3 一个真实对比有框架和没框架的差距我拿同一个任务做过对比——给一个中等规模的 Node.js 项目加一个带缓存的 API 接口。没有框架时我的操作是直接让 Claude Code 写接口代码它写完了我手动去改路由、加缓存依赖、跑测试来回折腾了七八轮中间还因为没告诉它项目的缓存库用的是哪个它默认用了内存缓存而项目实际用的是 Redis。有框架时我先做三件事把项目的package.json、路由目录结构、已有的缓存封装文件一起读进来明确告诉它缓存必须复用src/utils/cache.js里的封装要求它先输出改动计划再动手。结果它一次性给出了正确的实现我只做了微调。差距不在模型能力在于你有没有在任务开始前把约束条件和验收标准讲清楚。这就是技能框架的价值。3. Claude Code 从零到跑通安装、配置与第一个任务3.1 安装前的环境准备别跳过这一步Claude Code 官方推荐 Node.js 18 以上版本。我见过太多人卡在安装环节八成是 Node 版本太老或者 npm 权限有问题。先确认环境node -v npm -v如果 Node 版本低于 18建议用 nvm 管理版本别直接升级系统 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 环境下兼容性问题比较多热搜词里那条由于与64位版本的windows不兼容就是典型症状。最稳的方案是装 WSL2在 Ubuntu 子系统里跑体验和 Linux 几乎一致。3.2 安装 Claude Code 与首次登录环境就绪后安装本身很简单npm install -g anthropic-ai/claude-code装完验证一下claude --version首次运行claude会引导你登录。这里有个常见困惑注册账号和不注册有什么区别简单说登录账号后你用的是官方订阅额度能享受完整的模型能力和更新不登录的话部分功能会受限而且没法用一些需要身份校验的高级特性。如果你所在地区提示might not be available in your country那属于服务可用性限制这种情况可以考虑通过第三方 API 接入的方式使用其他模型后面会讲。3.3 VS Code 里配置 Claude Code插件还是终端很多人纠结要不要装 VS Code 插件。我的建议是两个都用但分工明确。VS Code 插件的优势是能直接读取编辑器里的当前文件和选区适合针对某段代码做局部修改的场景。终端版 Claude Code 的优势是能执行命令、跑测试、操作文件系统适合完成一个完整任务的场景。插件配置的关键点在于确保插件能找到你的 Claude Code 可执行文件路径。如果插件报找不到 claude 命令在插件设置里手动指定路径通常是which claude # 输出类似 /usr/local/bin/claude把这个路径填进插件配置3.4 用 CC Switch 接入第三方模型DeepSeek、Qwen、GLM 怎么选这是热搜里问得最多的一块。Claude Code 默认走官方模型但通过 CC Switch 这类工具可以把它接到 DeepSeek、Qwen、GLM 等第三方模型上。为什么有人要这么做两个原因一是成本二是某些模型在特定任务上表现更好。配置思路是CC Switch 负责管理不同模型的 API 端点和密钥Claude Code 通过环境变量指向 CC Switch 提供的本地代理地址。大致流程# 设置 API 基础地址指向本地代理 export ANTHROPIC_BASE_URLhttp://localhost:你的端口 export ANTHROPIC_API_KEY你的密钥选模型的实战经验DeepSeek 在代码生成和逻辑推理上性价比很高适合日常开发Qwen 在中文语境理解和长文本处理上有优势GLM 在工具调用和结构化输出上比较稳。我的做法是日常任务用 DeepSeek遇到需要大量中文文档理解的任务切 Qwen需要 AI 频繁调用工具链时用 GLM。切换成本很低值得按任务类型灵活选。注意第三方模型的工具调用能力参差不齐如果发现 AI 不执行命令、不读文件先检查模型是否支持 function calling这是终端智能体的命脉。4. Codex CLI 的核心命令与实战用法4.1 Codex CLI 和 Claude Code 的定位差异Codex CLI 是另一条技术路线。如果说 Claude Code 更像全能型协作者Codex CLI 则更偏向命令行里的精准执行者。它的命令设计更贴近传统 CLI 工具的习惯适合已经熟悉终端操作、想要快速完成特定任务的开发者。安装同样基于 npmnpm install -g openai/codex装完直接codex启动。它的交互模式和 Claude Code 类似都是对话式但命令体系有自己的特点。4.2 那几个必须记住的斜杠命令热搜里专门问了codex cli 命令哪些我挑几个高频的讲透/compact—— 这个命令的作用是压缩对话历史。终端智能体跑久了上下文会越来越长既费 token 又拖慢响应。/compact会把之前的对话总结成精简版本保留关键信息丢掉冗余。我的习惯是每完成一个子任务就 compact 一次保持上下文清爽。/model—— 切换当前使用的模型。不同任务用不同模型是常态比如写代码用强推理模型写文档用长文本模型一条命令切换不用重启。/resume—— 恢复之前的会话。这个太重要了。终端关了、电脑重启了之前的上下文还在/resume一下接着干。我经常一个复杂任务分几天做全靠这个命令续上。删除指令—— 热搜里提到删除 codex cli 指令指的是清理不再需要的会话记录或配置。具体命令随版本变化建议用codex --help查当前版本的准确用法别照搬网上的老教程。4.3 Codex CLI 配合 Remotion 做视频生成热搜里有个很有意思的组合codex cli remotion。Remotion 是一个用 React 写视频的框架而 Codex CLI 可以帮你生成和调试 Remotion 代码。这个组合的价值在于视频这种通常需要可视化编辑的东西现在可以用代码描述而 AI 能帮你写代码。实操思路是先用自然语言描述你想要的视频效果比如一个文字从左滑入、停留两秒、再淡出的开场让 Codex CLI 生成对应的 Remotion 组件代码然后本地渲染预览根据效果再调整。这个流程把视频制作变成了代码迭代对程序员来说反而更顺手。4.4 命令速查表命令作用使用场景/compact压缩对话历史上下文过长、响应变慢时/model切换模型不同任务需要不同模型时/resume恢复历史会话中断后继续之前的任务--help查看所有命令不确定命令用法时5. 把工具用成超能力一套可复用的技能框架5.1 任务开始前的三件套准备这是我用得最顺的一套开场流程每次新任务都走一遍第一喂上下文。把相关的目录结构、关键文件、配置文件一次性读进来。别指望 AI 自己猜它猜不准。第二定约束。明确告诉它必须用什么库不能改哪些文件代码风格遵循什么规范。约束越清晰返工越少。第三要计划。让它先输出改动计划你确认后再动手。这一步能拦掉大部分方向性错误。5.2 让 AI 直接执行终端命令的正确姿势Claude Code 能直接执行终端命令这是它区别于普通补全工具的核心能力。但很多人不敢用怕它乱执行。我的经验是给它执行权限但要求它先说明再执行。具体做法是在提示里加一句执行任何命令前先用一句话说明这条命令的作用和预期结果。这样你既享受了自动化又保留了监督权。遇到危险命令比如rm -rf它会先告诉你你有机会喊停。5.3 本地模型接入LM Studio 的玩法热搜里问claude code 调用 lmstudio 的本地模型这是个进阶玩法。LM Studio 能在本地跑开源模型通过它提供的本地 API 端点可以让 Claude Code 走本地模型。好处是数据不出本机、零 API 成本代价是本地模型的能力通常弱于云端大模型适合对隐私敏感或纯离线场景。配置核心还是环境变量指向 LM Studio 的本地地址export ANTHROPIC_BASE_URLhttp://localhost:1234/v1 export ANTHROPIC_API_KEYlm-studio提示本地模型对工具调用的支持差异很大接入后先跑个简单任务验证它能不能正确读文件、执行命令再投入正式使用。5.4 飞书等协作工具怎么和 Claude Code 打通飞书如何连接 claude code这类需求本质是想让 AI 能力进入团队协作流。常见做法是写一个中间服务飞书机器人收到消息后转发给 Claude Code 的接口把结果回传。这不是开箱即用的功能需要一点开发工作但思路很清晰——把 Claude Code 当成一个可编程的能力后端前端接什么飞书、Slack、自建网页都行。6. 踩过的坑和几条保命经验6.1 环境类坑Windows 兼容性和权限问题前面提过 Windows 原生环境的兼容性问题这里再强调一次能上 WSL2 就上 WSL2。我见过太多人在 Windows 上折腾半天最后换到 WSL2 十分钟搞定。另外 npm 全局安装如果报权限错误别用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是团队账号常见问题。遇到这个先确认是不是组织管理员关闭了相关权限这是账号策略问题不是技术问题。如果是个人使用遇到地区限制那就走第三方 API 接入的路子前面讲过配置方法。6.3 使用类坑别让 AI 一次改太多这是我最想强调的一条经验。AI 一次改动的文件越多出错的概率越高而且出错后越难定位。我的铁律是一个任务最多涉及三到五个文件超过就拆。宁可多轮小改动不要一轮大重构。大重构看起来爽但一旦引入隐蔽 bug排查成本远超你省下的时间。6.4 上下文类坑什么时候该 compact判断标准很简单当你发现 AI 开始忘记前面说过的约束或者响应明显变慢时就该 compact 了。别等到它彻底跑偏才处理。我一般每完成一个独立子任务就 compact 一次保持上下文始终聚焦在当前任务上。7. 关于超能力这件事我的一点真实体会用了大半年 Claude Code 和 Codex CLI我最大的转变不是写代码变快了而是思考任务的方式变了。以前拿到需求直接开写现在会先想这个任务的边界在哪、约束是什么、怎么拆成可验证的步骤、哪些部分可以交给 AI。这套思维方式其实和带一个真人团队是一样的——你得会拆解、会沟通、会验收。superpowers 这个项目名起得挺准。AI 编程助手本身没有超能力它是一面镜子照出的是你组织任务、表达需求、把控质量的能力。你把方法论理顺了它就是超能力你只会甩一句帮我写代码它就是个高级补全。工具是死的框架是活的真正值钱的是那套把工具用出花来的经验。如果你刚开始接触我的建议是别贪多先把 Claude Code 装起来跑通一个真实的小任务把喂上下文、定约束、要计划这三步走顺。等你对它的脾气摸熟了再考虑接第三方模型、接本地模型、接协作工具这些进阶玩法。一步一步来比一上来就搭一套复杂框架要靠谱得多。