和很多人想的不一样AI 编程这两年真正的分水岭其实不在模型参数也不在哪个 IDE 更好用而是开发者的工作方式发生了肉眼可见的改变。你一定见过这些词Vibe Coding、Superpowers、Claude Code、Codex。它们频繁出现在各种帖子和视频里但多数人卡在同一个位置工具装好了、账号登录了然后打开命令行盯着提示符不知道下一步到底该干什么。这篇文章想解决的就是这个问题。我会从零开始把 Claude Code、Codex 和 Superpowers 这套组合拆开讲清楚它们分别解决什么、怎么安装、怎么配置、怎么用在真实项目里以及那些你大概率会遇到的报错到底该怎么排查。读完以后你可以照着步骤用自己的自然语言跑通一个完整的小项目。先给一个判断Vibe Coding 不是玄学也不是“偷懒式写代码”它是一套有结构的工作流。而 Superpowers 这类 skill 系统恰恰是把 AI 从“问一句答一句”的聊天工具升级成“有工作记忆、有任务拆解能力、有测试意识”的开发搭档的关键。这篇文章就围绕这个判断展开。1. 这篇文章真正要解决的问题先说痛点。过去两年“AI 编程工具”这个概念已经被说烂了但你会发现一个奇怪的现象同样的工具有人用 ChatGPT 写个小脚本都费劲有人却能用 Claude Code 独立完成一个带前端、后端、数据库的小项目。差别真的在“会不会写提示词”吗不完全是真正的差别是谁掌握了一套完整的 AI 编程工作流。很多零基础用户的真实经历是这样的下载了 Cursor打开了一个 AI 对话框输入“帮我写一个商城系统”然后得到了几千行代码看不懂不会跑报错也不知道找谁。这不是工具的错而是缺少一个关键环节——把大需求拆成小任务并且在每一步验证结果。命令行 Agent 工具和 skill 系统的出现恰恰是为了补上这个环节。这套组合里的几个关键词分别对应了不同层次的能力Claude Code是 Anthropic 推出的命令行 AI 编程工具它能读取整个项目目录、修改文件、执行命令像一个坐在终端里的结对程序员。Codex是 OpenAI 开源的编程代理同样在终端里工作支持自定义模型供应商适合用来完成自动化编码任务。Superpowers是社区流行的 skill 集合给 Claude Code 等工具注入结构化的开发方法比如头脑风暴、任务拆解、测试驱动开发。Vibe Coding则是一种新的编程状态用自然语言主导开发节奏人类负责判断和把控方向AI 负责大量重复编码工作。这篇文章会从零开始演示如何安装这两个命令行工具如何配置 Superpowers如何用自然语言让 AI 从空目录开始生成一个可运行的待办事项工具以及如何把第三方大模型接进来。全程不假设你有任何编程基础但会尽可能给出可直接复制的命令和代码。2. 核心概念Vibe Coding 与 Superpowers 到底在说什么2.1 Vibe Coding 的通俗解释Vibe Coding 这个词最早流行起来的时候很多人把它理解成“对着 AI 说几句就好代码随便它写”。这是最大的误解。实际落地时Vibe Coding 是一套有节奏的开发方式先描述意图再让 AI 生成方案然后运行测试、观察结果、修正 prompt继续循环。你可以把它类比成“带着一个执行力很强但需要你拍板的实习生写代码”。你不能只说“做个网站”而是要说清楚做什么、给谁用、大概长什么样。更重要的是你要学会在 AI 给出的结果里发现问题而不是把问题全部丢给它。换句话说Vibe Coding 不是放弃编程而是把编程的重心从“怎么写”转移到“怎么决策”。2.2 Superpowers 是什么Superpowers 是一个社区项目它的核心想法很朴素与其每次都在 prompt 里花大量篇幅教 AI“你要先拆任务、再写测试、再实现”不如把这些标准流程打包成一个个可复用的 skill 文件。skil 是 Agent 工具中一种结构化的能力描述通常是 Markdown 格式里面写清楚触发条件、执行步骤、输出要求。在传统用法里你给 AI 一个任务它直接给出答案。但有了 Superpowers 之后遇到复杂任务AI 会先执行头脑风暴、拆解任务、列出计划再开始动手。这大大降低了项目失控的概率。很多用户第一次用 Superpowers 的感觉是“它突然像一个老练的开发者了而不是一个急于交答案的应届生。”2.3 OpenSpec 与工程规范在 Superpowers 相关的讨论中你还会频繁看到 OpenSpec 这个词。OpenSpec 是一种以 Markdown 文档为核心的工程规范工作流它的思路是把项目需求、变更规格、接口约定用结构化文档管理起来让 AI 在动手之前先理解规则。实际协作时OpenSpec 负责定义“项目边界和规范”Superpowers 负责提供“开发方法”两者结合以后AI 既知道该遵守什么规则也知道该怎么一步步推进。这套组合特别适合多人协作项目因为 AI 生成的代码至少是在一个统一的规范框架下产生的。2.4 对比传统编程、普通 AI 问答、AgentSkill 工作流维度传统编程普通 AI 问答Agent Skill 工作流代码产出方式人工手写AI 生成片段人工粘贴AI 在项目目录内直接修改文件任务拆解程序员自己做通常不做直接给结果Skill 强制先拆解再执行测试验证程序员写测试没有流程中自动生成并运行测试上下文感知人脑维护单轮对话容易丢失Agent 读取整个目录或 git 状态适合人群专业开发者所有人想真正落地 AI 编程的人这个表格基本回答了“为什么装了 AI 工具效率却没有提升”的疑问大多数人的用法还停留在第二列Vibe Coding 真正改变的是第三列。3. Claude Code 与 Codex 的定位对比这一节先把两个核心工具的关系理清。很多初学者会把 Claude Code 和 Codex 当成二选一的东西甚至觉得“有了 Claude Code 就不需要 Codex”。实际上它们是可以协同工作的。Claude Code的特点是深度上下文理解。它会读取你项目里的文件、git 历史、目录结构并且能和 Claude 模型对话。你在终端里输入claude启动以后它会以会话方式工作你可以让它“看一下 src 目录下的代码找出 bug然后直接修复”。它适合复杂度较高的业务逻辑、重构、代码审查这类需要理解全貌的任务。Codex是 OpenAI 开源的命令行编程工具同样支持在终端里执行命令、修改文件。但从社区实践来看Codex 的一个显著优势是它的配置更灵活它允许通过配置文件接入不同的模型提供商这一点在后面接入 DeepSeek 等第三方模型时会非常方便。那到底选哪个我的建议是不要二选一先都装上。日常主力开发可以用 Claude Code遇到需要快速验证自动化任务、或者你只有第三方模型 API 时切到 Codex。两个工具共用一套项目目录和 git 仓库不会互相冲突。此外还有一个经常被提到的工具叫 CC Switch它用来在多个 Claude 账号、Codex 配置之间快速切换也可以用来安装和管理 Superpowers 相关插件。如果你只有一个账号暂时不需要它如果以后你在多个项目里用了不同的账号配置再考虑引入。4. 环境准备安装 Claude Code 与 Codex4.1 前置条件Claude Code 和 Codex 主要依赖 Node.js 运行环境。如果你没有安装 Node.js需要先到官网下载 LTS 版本。具体版本要求以工具官方文档为准但一个稳妥做法是安装当前 Node.js 的 LTS 版本。安装完成后在终端确认环境node -v npm -v如果这两个命令都能输出版本号说明 Node.js 环境正常。执行前先明确一点以下命令都是在终端macOS 的 Terminal、Windows 的 PowerShell 或 WSL中执行的。4.2 安装 Claude CodeClaude Code 官方推荐的安装方式是通过 npm 全局安装。一般情况下执行npm install -g anthropic-ai/claude-code安装完成后验证版本claude --version首次使用时会遇到认证流程。Claude Code 支持两种主要方式如果你有 Claude 的订阅账号可以先执行claude按提示完成登录授权。如果你使用的是 API Key可以通过环境变量把密钥传给工具。执行claude后进入交互式终端会出现一个提示符。这里就可以直接用自然语言下达任务了。第一次进入时建议先运行/status或查看帮助确认工具已经真正连上了模型服务。4.3 安装 CodexCodex 的安装方式同样依赖 npm也可以使用 Homebrew# 方式一npm 全局安装 npm install -g openai/codex # 方式二macOS 用户可以使用 Homebrew brew install codex安装后验证codex --versionCodex 首次使用需要认证。如果你使用的是 OpenAI 官方服务通常执行codex login走浏览器授权即可。如果你打算接入第三方模型服务则需要在配置文件里单独设置。认证成功后在任意项目目录执行codex就能进入类似 Claude Code 的交互式终端。4.4 在 VS Code 里使用很多用户不习惯纯命令行操作这时候可以把 Claude Code 或 Codex 集成到 VS Code 里。VS Code 的终端窗口可以直接打开外部终端所以最简单的用法是在 VS Code 中打开项目然后点击菜单栏的“终端”在终端里运行claude或codex。这样你既能看代码又能和 AI 对话AI 修改文件后编辑器里的代码会实时变化。一些第三方扩展还会提供图形化的 Agent 面板但从学习曲线来看先用终端是最稳的。因为这样你能清楚看到每一条命令的执行过程对排错很有帮助。5. 安装 Superpowers Skill 与 OpenSpec 协作5.1 Skill 放在哪里Claude Code 的 skill 通常放在用户级目录或项目级目录。用户级目录对所有项目生效项目级目录只对当前项目生效。一般步骤是从 GitHub 或其他可信渠道下载 Superpowers 项目到本地。把其中的 skills 目录放到 Claude Code 的 skill 目录下。重新启动 Claude Code让工具加载新 skill。目录结构通常是这样的~/.claude/skills/ └── superpowers/ └── SKILL.md不同版本的项目结构可能略有差异具体以你下载的仓库 README 为准。核心文件是SKILL.md它描述了 skill 的用途以及触发时机。社区中还经常提到一个安装方式在 CC Switch 里直接安装 Superpowers 插件这对不熟悉命令行文件操作的用户更友好。5.2 在 Claude Code 中查看和启用 Skill启动 Claude Code 后输入 /skills如果 Skill 安装成功你会看到已加载的 skill 列表其中应该包含 Superpowers 相关条目。在对话中你可以直接对 Claude 说使用 superpowers 技能帮我规划一个待办事项 Web 应用的开发步骤。这时 Claude 会按照 Skill 中的流程先拆解任务、列出计划再开始动手。这是判断 skill 是否真正生效的最直接方式。如果它仍然只是简单回答没有按流程拆解说明 Skill 没有被正确加载需要检查目录路径和SKILL.md格式。5.3 把 OpenSpec 引入工作流OpenSpec 的核心用法是给项目增加一套 Markdown 形式的规范文件。你可以把接口约定、数据模型、目录结构、开发原则都写成文档放到项目的specs/目录下。在启动 Claude Code 时它会读取这些文档作为生成代码的上下文。一个典型的协作流程是在specs/里定义本次需求例如“用户能新增任务、标记完成、删除任务”。在 Claude Code 中描述需求并指定参考specs/目录。Claude Code 结合规范和 Superpowers 的流程完成编码。对于小项目OpenSpec 可能显得繁琐但一旦项目有多个模块、多个协作者它就能显著减少“AI 写出了和团队规范完全不一致的代码”这类问题。6. 实战案例用 Claude Code Superpowers 写一个最小项目下面进入全文最关键的实操环节。我们用一个典型场景演示整个流程从零编写一个带优先级和截止日期的待办事项命令行工具。这个项目足够简单但覆盖了任务拆解、代码生成、运行验证、修改迭代的完整闭环。6.1 项目准备先在本地创建项目目录mkdir ~/projects/todo-cli cd ~/projects/todo-cli git init把空目录初始化成 git 仓库是一个好习惯。因为 Claude Code 会读取 git 状态这能帮助它理解项目变化也方便你随时回滚。然后启动 Claude Codeclaude6.2 给 AI 的第一条指令进入交互界面后输入使用 superpowers 技能。 请在这个空目录中开发一个 Python 命令行待办工具功能要求 1. 支持 add、list、done、remove 四个子命令 2. 数据保存到本地 todo.json 文件中 3. 每条任务包含 id、内容、优先级、状态、创建时间 4. 优先级分为 high、medium、low 5. 提供命令行帮助信息。 请先拆解任务再开始编写代码。注意这条 prompt 的几个要点它指定了技术栈、功能清单、数据存储格式并且要求“先拆解再编码”。这与直接问“帮我写个待办工具”有本质区别。6.3 预期会看到的流程如果 Superpowers skill 正常加载Claude Code 会先输出一个简短的开发计划例如第一步设计数据结构第二步创建测试用例第三步实现核心函数第四步补充命令行参数解析第五步运行测试并修复。随后它会在目录中创建代码文件。这里给出一段可能由 AI 生成、也可以由你手动参考实现的示意代码。真正重要的是理解这个文件的结构而不是纠结它是否和你的环境完全一致# todo.py import argparse import json import os from datetime import datetime TODO_FILE todo.json def load_tasks(): if not os.path.exists(TODO_FILE): return [] with open(TODO_FILE, r, encodingutf-8) as f: return json.load(f) def save_tasks(tasks): with open(TODO_FILE, w, encodingutf-8) as f: json.dump(tasks, f, ensure_asciiFalse, indent2) def add_task(content, priority): tasks load_tasks() task_id max([t[id] for t in tasks], default0) 1 tasks.append({ id: task_id, content: content, priority: priority, status: todo, created_at: datetime.now().isoformat() }) save_tasks(tasks) print(f任务已添加id{task_id}) def list_tasks(): tasks load_tasks() if not tasks: print(当前没有任务) return for t in tasks: print(f[{t[id]}] ({t[priority]}) {t[content]} - {t[status]}) def done_task(task_id): tasks load_tasks() for t in tasks: if t[id] task_id: t[status] done save_tasks(tasks) print(f任务 {task_id} 已完成) return print(f未找到 id{task_id} 的任务) def remove_task(task_id): tasks load_tasks() new_tasks [t for t in tasks if t[id] ! task_id] if len(new_tasks) len(tasks): print(f未找到 id{task_id} 的任务) return save_tasks(new_tasks) print(f任务 {task_id} 已删除) def main(): parser argparse.ArgumentParser(description待办事项命令行工具) subparsers parser.add_subparsers(destcommand) add_parser subparsers.add_parser(add, help添加任务) add_parser.add_argument(content, help任务内容) add_parser.add_argument(--priority, choices[high, medium, low], defaultmedium) subparsers.add_parser(list, help列出任务) done_parser subparsers.add_parser(done, help完成任务) done_parser.add_argument(task_id, typeint, help任务 id) remove_parser subparsers.add_parser(remove, help删除任务) remove_parser.add_argument(task_id, typeint, help任务 id) args parser.parse_args() if args.command add: add_task(args.content, args.priority) elif args.command list: list_tasks() elif args.command done: done_task(args.task_id) elif args.command remove: remove_task(args.task_id) else: parser.print_help() if __name__ __main__: main()这段代码的核心逻辑并不复杂数据用 JSON 文件持久化命令通过argparse解析。你不需要一下子读懂每一行但要知道它对应了 prompt 里的哪一条需求。比如“数据保存到本地 todo.json”对应的是load_tasks和save_tasks两个函数“优先级分为 high、medium、low”对应的是--priority参数的choices限制。如果 Claude Code 生成的代码和这个示例不同也不用紧张只要功能完整即可。接下来要做的是验证。7. 运行结果与效果验证7.1 运行命令回到终端退出 Claude Code 的交互界面或者另开一个终端窗口执行# 添加一条高优先级任务 python todo.py add 学习 Claude Code --priority high # 再添加一条中优先级任务 python todo.py add 配置 Codex --priority medium # 查看任务列表 python todo.py list # 标记第一条任务完成 python todo.py done 1 # 再次列出确认状态变化 python todo.py list7.2 预期输出正常情况下第一次运行list会看到类似输出[1] (high) 学习 Claude Code - todo [2] (medium) 配置 Codex - todo执行done 1后再运行list[1] (high) 学习 Claude Code - done [2] (medium) 配置 Codex - todo同时目录下会生成一个todo.json文件里面保存了任务的完整数据。这说明 AI 生成的代码不仅能运行而且数据持久化功能是正常的。7.3 如何判断成功有三个判断标准命令没有报错退出码为 0数据写入todo.json且格式正确重复运行list时任务状态能保持一致。如果运行失败最常见的错误是模块缺失或语法错误。第一步应该查看终端里的完整报错信息确认是在哪一行出错然后把错误信息复制回 Claude Code让它自己修复。这一步是 Vibe Coding 的核心体验AI 写的代码AI 负责改你负责验证。8. 扩展把 DeepSeek 等第三方模型接入 Claude Code 与 Codex8.1 为什么需要接入第三方模型Claude Code 默认使用 Claude 系列模型但不少开发者因为成本、可用性或团队要求希望接入 DeepSeek 等第三方大模型。社区里相关讨论非常多比如“Claude Code 接入 DeepSeek”“Codex 接入 DeepSeek”都是高频搜索词。接入方式一般不是通过官方客户端设置而是通过环境变量或配置文件指定模型服务的地址和模型名称。8.2 Claude Code 接入第三方模型的基本思路常见做法是设置环境变量让 Claude Code 指向第三方兼容接口export ANTHROPIC_BASE_URLhttps://api.example.com export ANTHROPIC_MODELdeepseek-chat export ANTHROPIC_API_KEY你的密钥不同第三方服务对 API 地址和模型名的要求不一样。真正稳定的方式是查看你所选服务商提供的大模型接入文档按要求填写。需要特别提醒的是模型名必须使用服务商支持的名字而不是自定义的任意字符串。社区里一个典型报错是deepseek-v4-pro is not a model this version of claude code recognizes这个报错说明配置里写的模型名没有被当前版本的 Claude Code 识别。可能是名字写错、服务商不支持或者 Claude Code 版本太旧无法适配新模型名。排查顺序是确认服务商文档里的准确模型名改到配置里重启工具升级 Claude Code 到最新版。8.3 Codex 接入自定义模型供应商Codex 的优势在于配置文件设计得更开放。它的配置通常位于~/.codex/目录下常见的管理方式是编辑配置文件在配置中声明自定义供应商和模型。大致思路是在配置中增加一个模型供应商段落指定该供应商的 base URL、API Key 环境变量名将默认模型指向这个供应商提供的模型名。具体字段名和格式建议以官方文档为准因为不同版本变化较快。接入成功后在codex交互界面中确认返回的响应是否正常。如果出现类似 “cc switch local proxy failed while handling codex endpoint /responses” 的报错通常与本地代理、版本兼容有关后面的常见问题章节会展开说明。8.4 一个重要提醒接入第三方模型时注意模型能力差异。Claude Code 的很多高级功能比如深度文件修改、长上下文理解依赖模型本身的能力。如果接入了能力较弱的第三方模型体验可能明显下降。所以第三方接入更适合作为备用方案而不是默认方案。在 A/B 对比之后再决定是否长期使用是更理智的做法。9. 常见问题与排查思路下面这些报错都是从真实使用中高频出现的问题整理成表格方便对照排查。问题现象可能原因排查方式解决方案unable to locate the codex cli binary. set codex cli path or ensure the elec...系统找不到 Codex 可执行文件在终端执行which codex或where codex查看路径安装 Codex 后确认全局命令可用如果使用了 CC Switch在设置中手动指定 Codex CLI 路径cc switch local proxy failed while handling codex endpoint /responses. provi...CC Switch 本地代理与 Codex 版本不兼容或本地代理服务未正常启动查看 CC Switch 的代理日志确认端口状态升级 CC Switch 和 Codex 到最新版重启本地代理检查代理端口是否被占用your organization has disabled claude subscription access for claude codeClaude 账号属于组织版组织管理员禁用了 Claude Code 访问联系管理员确认权限让管理员开启该权限或改用 API Key 方式认证deepseek-v4-pro is not a model this version of claude code recognizes配置的模型名不被当前版本识别核对服务商文档中的准确模型名检查 Claude Code 版本修改配置为正确模型名或升级 Claude Code安装npm install -g anthropic-ai/claude-code失败Node.js 版本过低、npm 镜像不可达查看 npm 错误日志升级 Node.js LTS 版本检查网络和 npm 源Claude Code 无法读取项目文件目录权限不对或在未初始化的 git 仓库中运行检查目录权限执行git init给目录设置正确读写权限在项目根目录启动工具Superpowers skill 安装了但没有生效skill 目录路径不对或SKILL.md格式不正确执行/skills查看已加载列表把 skill 放到正确的用户级或项目级目录检查文件格式排查时有一个通用原则先看完整报错再问 AI最后才是问搜索引擎。把报错信息原样复制给 Claude Code 或 Codex往往比手动搜索更快因为它们能看到你当前的上下文和配置。10. 最佳实践与工程建议10.1 提示词要像项目需求文档而不是聊天用 Vibe Coding 时最忌讳的是只写一句“帮我做个 xx”。好的 prompt 通常包含五个要素技术栈、功能列表、数据存储方式、约束条件、验证方式。就像前面实战案例里做的那样。你可以把常用的要求整理成模板每次复用效率会高很多。10.2 让 AI 先写测试再写实现Superpowers 这类 skill 强调测试先行原因很实际没有测试AI 改了一处代码你根本不知道是不是破坏了另一处功能。在一个小项目里让 AI 顺便生成一个简单的测试脚本长期收益非常明显。10.3 API Key 安全底线无论使用 Claude Code、Codex 还是第三方模型接入API Key 都是你的凭证。务必遵守几条底线不要把 Key 写进代码仓库在.gitignore中排除.env等配置文件给 Key 设置额度上限定期轮换。如果 Key 泄漏第一时间到服务商后台吊销。10.4 用 git 保住回滚能力Agent 工具会自动修改文件这既是优点也是风险。建议在每次让 AI 做较大改动之前先提交一次 git。这样如果 AI 改出了奇怪的东西你可以随时git checkout .回滚。不要完全信任 AI 对文件的修改尤其是生产环境。10.5 最小权限与生产环境谨慎如果以后把这类工具用于生产环境务必遵守最小权限原则。不要在服务器上用 root 权限运行 Claude Code不在没有备份的情况下执行删除、迁移类操作高危操作先在测试环境验证。AI 编程工具提高了效率但没有消除工程纪律的必要性。10.6 工作目录范围控制Claude Code 默认会读取项目目录内的文件但如果你在错误的目录启动它它可能会修改到不想修改的文件。建议每个项目单独建目录在项目根目录启动工具不要让 Agent 在用户主目录或系统目录里乱跑。10.7 周期性的代码审查很多人把 Vibe Coding 理解成“AI 全自动人只看结果”。这在一个学习项目里没问题但在正式项目里不行。更稳妥的做法是让 AI 每完成一个阶段就停下来解释改了什么、为什么这么改然后你抽查关键文件。你不需要懂每一行但你要能看懂整体结构。11. 总结与后续学习方向回到开头那个判断AI 编程真正的分水岭是工作方式的改变。Claude Code、Codex 解决了“AI 能不能在真实项目里动手”的问题Superpowers 解决了“AI 有没有结构化开发方法”的问题OpenSpec 解决了“AI 写出来的东西是否和团队规范一致”的问题。这三层结合起来才是零基础用户真正可以依赖的 AI 编程工作流。下一步的建议很具体不要贪多先照着本文的实战案例跑通一次。等你熟悉了基本流程再去尝试更复杂的项目比如带 Web 界面的工具、对接第三方 API 的小应用或者把 Codex 配置成你常用模型的自动化执行器。每一次跑通你对“如何与 AI 协作编程”的判断都会更准。建议把本文收藏备用尤其是其中的安装命令、prompt 模板和排查表格。当你第一次在终端里敲下claude或者codex时对照着这篇文章操作会少走很多弯路。如果你在实践过程中遇到了新的报错欢迎在评论区分享出来这类问题往往有很强的通用性能帮到一批和你一样正在入门 AI 编程的人。