最近一段时间“Vibe Coding”这个词在技术社区里几乎刷屏了。很多程序员的第一反应是这不就是让 AI 帮着写代码吗我早就在用 Copilot 了有什么新鲜的但如果你只是把它理解为“AI 自动补全的升级版”可能真的低估了这一轮变化。Vibe Coding 背后代表的是开发工作流的一次结构性调整从“人写代码、AI 补全”变成“人描述意图、AI Agent 直接操作工程”。更关键的是这套工作流不再要求你先把语法、框架、调试技巧学个遍零基础的人也可以借助 Claude Code、Codex 这类工具从一句自然语言开始完成一个可运行、可测试、可迭代的真实项目。这篇文章不打算做概念科普而是直接用 Claude Code Codex 组合带你完整体验一遍“从 AI 对话到 AI 协作开发”的实战流程。你会看到它们解决什么问题、安装配置怎么做、真实项目怎么跑通、常见报错怎么排查以及这套新工作流的边界在哪里。1. 为什么 Vibe Coding 值得程序员重新学习先说一个容易被误解的事实Vibe Coding 不是“随便聊聊就让 AI 把活干完”它是一套有方法论的人机协作开发方式。传统开发流程里一个功能从想法到上线需要经历需求分析、技术选型、编码、调试、测试、代码审查等多个环节。每个环节都依赖开发者自身的知识储备。尤其对于刚入行的新人光是把环境配好、把框架跑通就足以消耗掉一天时间。Vibe Coding 改变的是这个链条里的“编码执行”环节。它的核心思路是用自然语言描述你要什么AI Agent 负责在项目里具体执行——创建文件、编写逻辑、安装依赖、运行测试、根据报错自动修复。人和机器的关系从“操作者与工具”变成了“产品经理与执行工程师”。这带来两个直接影响第一个影响是开发门槛被拉低了。过去“写一个待办事项管理工具”需要先学 Python 或 JavaScript再学命令行和 Git现在只要你能把需求说清楚AI 就能帮你生成一个可运行的版本。第二个影响是开发效率的重心变了。对会写代码的人来说真正的耗时点往往不是“写出来”而是“改来改去”——改需求、修 bug、调样式、适配边界。Vibe Coding 时代这部分工作可以大量交给 AI人只需要负责判断方向、验收结果、纠正错误。所以我的判断是Vibe Coding 不是让程序员变懒而是把程序员的精力从“代码生产”转移到“需求定义和质量把控”上。这个转变对所有开发者都值得认真对待。2. 核心概念Claude Code、Codex 与 Agent 工作流在进入实操之前有必要把几个容易混淆的概念理清楚。2.1 什么是 Vibe CodingVibe Coding 这个词由 Andrej Karpathy 提出指的是“完全沉浸在氛围中进行编程忽略细节让 AI 发挥主导作用”。本质上它是一种以 AI 为中心的编程方式你描述需求AI 写代码你负责反馈和修正。它和传统“AI 辅助编程”最大的区别在于辅助编程中 AI 是配角代码还是你写的Vibe Coding 中 AI 是执行者你的核心工作是描述、检查和迭代。2.2 什么是 Claude CodeClaude Code 是 Anthropic 推出的终端编程 Agent 工具。它不是一个简单的聊天框而是可以读取你的项目目录、创建和修改文件、执行 shell 命令、运行测试、提交代码的完整开发助手。它最大的特点是“工作在工作目录里”。你启动claude命令后它会感知当前项目的文件结构和上下文然后通过对话处理任务。2.3 什么是 CodexCodex 是 OpenAI 推出的编程 Agent同样提供 CLI 工具和云端执行环境。它擅长代码生成、重构、bug 修复、项目脚手架搭建等任务。Codex 的交互方式很接近“让一个远程工程师帮你写代码”——你可以把整个代码仓库交给它它会在沙箱环境里执行任务并返回结果。2.4 从 AI 对话到 AI 协作开发区别在哪里普通 AI 对话工具比如网页版 ChatGPT、Claude回答完问题就结束了。它不会主动去看你的项目文件不会帮你执行命令更不会根据运行报错自动修复代码。AI 协作开发工具则完全不同对比维度AI 对话AI 协作开发Agent上下文依赖你手动粘贴自动感知项目文件执行能力只返回文本可执行命令、改文件迭代方式你复制代码再粘贴自动修改并重新运行适用场景问答、解释、片段生成完整功能开发、重构、调试Claude Code 和 Codex 就属于后者。这也是为什么说“从 AI 对话到 AI 协作开发”是一个质变。3. 环境准备与前置条件在开始安装 Claude Code 和 Codex 之前先把基础环境准备好。这部分不难但要注意版本兼容。3.1 必备环境两个工具都依赖 Node.js所以第一步是装 Node.js。# 检查是否已安装 node -v npm -v如果提示找不到命令需要先安装 Node.js 20 或更高版本。具体版本请以官方文档为准本文重点演示通用思路不绑定某一个版本号。3.2 准备一个项目目录建议新建一个干净的目录用来做后面的实战练习。mkdir vibe-coding-demo cd vibe-coding-demo git init这里建议先执行git init好处是 AI 每次修改文件后你都能用 Git 看到具体变更方便审查和回滚。这一点非常重要后面最佳实践部分会详细说。3.3 账号与网络环境Claude Code 需要一个 Anthropic 账号并开通对应订阅权限。Codex 需要一个 OpenAI 账号并具备 Codex 使用权限。如果你的团队使用企业版管理后台需要确保组织管理员已经为你的账号开启 Claude Code 或 Codex 的访问权限。这里有一个容易踩的坑很多新手安装完成后运行工具发现提示“your organization has disabled claude subscription access for claude code”这不是你操作错了而是组织管理员没有放行需要联系管理员解决。4. Claude Code 安装与基础配置Claude Code 的安装方式很简单通过 npm 全局安装即可。npm install -g anthropic-ai/claude-code安装完成后在终端输入claude启动claude第一次启动会进入登录流程按提示完成账号授权即可。登录成功后你可以在项目目录里直接和 Claude Code 对话。4.1 常用命令和操作Claude Code 启动后是一个交互式终端界面常用操作如下/help查看帮助。/status查看当前会话状态。/init让 Claude Code 在项目里生成初始配置。/clear清空当前会话上下文。CtrlC两次退出。另外Claude Code 支持非交互模式适合在脚本中调用claude -p 请告诉我当前目录下有哪些文件-p是 print 模式执行完直接输出结果并退出非常适合自动化流程。4.2 权限确认机制当你让 Claude Code 创建文件、执行命令时它会逐一请求确认。这种机制虽然多点一下鼠标但能避免 AI 做出你意料之外的操作。实际使用中我建议新手不要关闭确认等熟悉了它的行为模式再决定是否放宽。5. Codex 安装与基础配置Codex 的安装同样通过 npm 完成。npm install -g openai/codex安装完成后需要先登录codex login登录流程会打开浏览器你只需要授权即可。授权完成后运行codex进入交互式会话。5.1 常用命令和操作codex进入交互式会话可以直接描述任务。codex exec 你的任务单次执行模式适合脚本化调用。codex eval用于评估模型的代码生成效果。看一个最简单的例子codex exec 在当先目录创建一个 Python 文件 hello.py内容为打印 Hello Codex执行后Codex 会在当前目录生成hello.py并且在沙箱环境里帮你运行验证。这就是它和普通对话工具最大的不同它给出代码后还会尝试运行根据结果自我修正。5.2 与 IDE 的配合很多读者会问这两个工具是终端操作能不能集成到 VSCode 里Claude Code 支持在 VSCode 等编辑器中配置Codex 目前也有官方 IDE 扩展。具体配置方式建议直接查看官方文档不同版本差异较大这里不展开写死。终端方式其实是理解 Agent 工作流的最佳起点。6. 实战从一句话到可运行项目现在进入全文最核心的部分。我们用一个真实的开发任务完整走一遍 Vibe Coding 工作流。任务目标开发一个命令行待办事项管理工具支持添加任务、查看任务、标记完成、删除任务并且数据要持久化到本地文件。6.1 第一轮用 Claude Code 搭建项目骨架在刚才创建的vibe-coding-demo目录中启动 Claude Codeclaude然后输入第一段提示词请用 Python 创建一个命令行待办事项管理工具 todo.py支持以下功能 1. 添加任务 2. 查看所有任务 3. 标记任务为完成 4. 删除任务 数据保存到本地 JSON 文件项目结构要简洁清晰适合初学者理解。Claude Code 会开始创建文件、编写代码。你会看到它输出每一步操作并请求确认。确认后项目里会出现todo.py# 文件路径vibe-coding-demo/todo.py import json import sys from pathlib import Path TODO_FILE Path(todos.json) def load_tasks(): if not TODO_FILE.exists(): 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(title): tasks load_tasks() tasks.append({id: len(tasks) 1, title: title, done: False}) save_tasks(tasks) print(f已添加任务: {title}) def list_tasks(): tasks load_tasks() if not tasks: print(暂无任务) return for task in tasks: status [x] if task[done] else [ ] print(f{task[id]}. {status} {task[title]}) def done_task(task_id): tasks load_tasks() for task in tasks: if task[id] task_id: task[done] True break save_tasks(tasks) print(f任务 {task_id} 已标记完成) def delete_task(task_id): tasks load_tasks() tasks [task for task in tasks if task[id] ! task_id] save_tasks(tasks) print(f任务 {task_id} 已删除) if __name__ __main__: if len(sys.argv) 2: print(用法: python todo.py add|list|done|delete [参数]) sys.exit(1) command sys.argv[1] if command add: add_task(sys.argv[2]) elif command list: list_tasks() elif command done: done_task(int(sys.argv[2])) elif command delete: delete_task(int(sys.argv[2])) else: print(未知命令)这段代码的思路很直接load_tasks和save_tasks负责读写本地 JSON 文件实现数据持久化。add_task、list_tasks、done_task、delete_task对应四个核心功能。主入口通过sys.argv解析命令行参数分发到不同函数。6.2 第二轮让 Claude Code 迭代功能第一版代码已经能跑但你会发现一个设计问题删除任务后再添加新任务id可能重复因为id是按照len(tasks) 1生成的。这时候继续在 Claude Code 会话里提出修改要求当前删除任务后重新添加任务id 会重复。请修复 id 分配逻辑 改为基于已有任务的最大 id 加 1并且在删除任务时做 id 重排保持 id 连续。Claude Code 会直接修改todo.py不再是让你手动操作。它读懂问题、重写逻辑、保存文件一气呵成。这就是“协作开发”和“对话问答”之间最直观的体验差异。修复后的核心逻辑会变成def next_id(tasks): return max((task[id] for task in tasks), default0) 1 def add_task(title): tasks load_tasks() task_id next_id(tasks) tasks.append({id: task_id, title: title, done: False}) save_tasks(tasks) print(f已添加任务: {title})如果 Claude Code 没有主动思考到这个隐患你可以直接提示它。这也是 Vibe Coding 的一个重要能力你不是在给 AI 打下手而是在做代码审查和需求定义。6.3 第三轮用 Codex 做代码审查项目跑通后换一个视角用 Codex 审查一遍代码质量。codex exec 请审查当前项目中的 todo.py重点关注1. 代码风格是否符合 PEP82. 是否有潜在的异常处理问题3. 命令行参数解析是否健壮。Codex 会读取todo.py给出审查意见并直接修改代码。常见的改进点包括使用argparse替代sys.argv参数的健壮性更好。增加文件读写异常处理。明确main()函数的入口。比如参数解析部分Codex 可能会改成import argparse def main(): parser argparse.ArgumentParser(description待办事项管理工具) subparsers parser.add_subparsers(destcommand) add_parser subparsers.add_parser(add, help添加任务) add_parser.add_argument(title, help任务标题) subparsers.add_parser(list, help查看所有任务) done_parser subparsers.add_parser(done, help标记完成) done_parser.add_argument(task_id, typeint, help任务 ID) delete_parser subparsers.add_parser(delete, help删除任务) delete_parser.add_argument(task_id, typeint, help任务 ID) args parser.parse_args() if args.command add: add_task(args.title) elif args.command list: list_tasks() elif args.command done: done_task(args.task_id) elif args.command delete: delete_task(args.task_id)这个改动让命令行工具的交互体验专业了很多也展示了两个 Agent 工具的互补性Claude Code 擅长从零搭建和迭代功能Codex 擅长做代码审查和工程质量改进。6.4 运行验证修改完成后在终端实际运行验证python todo.py add 学习 Vibe Coding python todo.py add 写一篇 CSDN 实战文章 python todo.py list python todo.py done 1 python todo.py list python todo.py delete 2 python todo.py list预期输出示例已添加任务: 学习 Vibe Coding 已添加任务: 写一篇 CSDN 实战文章 1. [ ] 学习 Vibe Coding 2. [ ] 写一篇 CSDN 实战文章 任务 1 已标记完成 1. [x] 学习 Vibe Coding 2. [ ] 写一篇 CSDN 实战文章 任务 2 已删除 1. [x] 学习 Vibe Coding如果任何一步报错先看报错信息定位到具体命令行参数还是代码逻辑问题再回到对应的 AI 会话中描述错误让 Agent 修复。7. 扩展接入其他模型与团队协作很多国内开发者会遇到一个现实问题Claude Code 和 Codex 默认依赖官方模型服务但实际项目中可能有不同的模型接入需求。社区里很常见的操作是“claude code 接入 deepseek”“codex 接入 deepseek”这类配置。7.1 修改模型接入的通用思路Claude Code 和 Codex 都支持通过环境变量指定 API 地址和模型名称。以 Claude Code 为例通用做法是export ANTHROPIC_BASE_URL你的模型网关地址 export ANTHROPIC_MODEL具体模型名称Codex 类似export OPENAI_BASE_URL你的模型网关地址 export OPENAI_MODEL具体模型名称需要特别提醒的是不同模型提供方、不同网关的接口协议可能存在差异配置项的具体名称和取值必须参考你所用服务商的官方文档不要照抄网上的配置。如果你使用的是订阅制官方服务通常不需要改这些变量只有当你希望通过第三方网关或自己的模型服务时才需要这样配置。7.2 关于 Skill、Harness 等扩展能力Claude Code 支持 Skills 机制你可以把常用的项目规范、代码风格、命令模板做成 Skill让 Claude Code 在不同项目中复用。Codex 也有 Harness 机制用于定义 Agent 如何感知项目、执行任务、验证结果。这些高级特性本质上是同一个思路把团队的项目经验和工程规范沉淀成 Agent 可以读取和执行的资产。如果团队准备大规模使用 AI 协作开发这些能力值得深入研究。8. 常见问题与排查思路我整理了 Vibe Coding 实践中出现的典型问题这些是开发者最容易卡住的环节。问题现象可能原因排查方式解决方案启动时报unable to locate the codex cli binaryIDE 插件或桌面端找不到 Codex CLI 可执行文件的路径确认是否已全局安装which codex全局安装 Codex CLI或在插件设置中正确配置 codex_cli_path切换代理后报cc switch local proxy failed本地代理配置异常或代理服务不可用检查本地代理服务状态和相关配置参数核对网络配置确认代理服务正常后重试提示your organization has disabled claude subscription access for claude code企业组织管理员未开放 Claude Code 访问权限登录组织管理后台查看 Claude Code 策略联系管理员开启对应权限出现 Claude Code 529 错误服务端负载过高或配额用尽查看官方状态页和账号配额等待一段时间重试或检查订阅额度提示model is not supported this version of claude code recognizes模型名称不在当前版本支持列表中或版本过旧检查模型名称拼写、升级 Claude Code 版本使用官方支持的标准模型名或升级工具版本Codex 执行任务时只生成代码但不运行沙箱执行被限制或当前配置关闭了自动执行查看执行日志和沙箱策略调整配置或手动复制代码到项目中验证排查问题的核心思路只有一条先看错误日志再定位配置最后才考虑代码问题。不要一遇到报错就怀疑 AI 能力不行大多数问题是环境配置问题。9. 最佳实践与工程建议用 Vibe Coding 不等于放弃工程规范。恰恰相反越依赖 AI 写代码越需要严格的工程约束。9.1 版本控制必须前置用任何 Agent 工具之前先git init。AI 每完成一次修改你都能通过git diff看到它改了什么。这不仅是审查手段也是回滚手段——AI 改坏了一条命令就能还原。git add . git commit -m feat: 初始版本 git diff # 查看修改9.2 明确需求边界分段交付不要一次让 AI 做“一个完整系统”而是拆成小任务先搭骨架再补功能再修 bug再优化。每段任务独立验证通过后再进入下一轮。这和你带一个初级工程师干活是一个道理。9.3 只给 AI 最小权限Claude Code 会请求确认Codex 有沙箱模式。默认情况下不要关闭安全限制。尤其涉及文件删除、命令执行、网络请求时先看看 AI 要做什么再决定是否放行。9.4 人工审查不能缺位AI 生成的代码能跑不代表没有隐患。边界条件、异常处理、安全漏洞、性能问题这些仍然需要人来把关。AI 是效率放大器不是质量保证。9.5 选择适合的场景Vibe Coding 擅长的是从零搭建项目脚手架。编写工具脚本和自动化任务。快速实现原型验证。重构代码、修复简单 bug。生成测试用例。它不适合的场景是涉及敏感数据的生产系统核心逻辑。需求高度模糊、需要大量业务判断的任务。安全合规要求极高的场景。这些场景适合用 AI 辅助但最终决策必须由有经验的人完成。9.6 沉淀团队级 Prompt 与 Skill当团队多人使用 Claude Code 或 Codex 时把常用的需求模板、代码规范、验收标准做成统一的 Prompt 模板或 Skill能显著提高输出质量和一致性。这也是 AI 协作开发从“个人玩具”走向“团队生产力工具”的关键一步。10. 总结与下一步建议回到开头的问题Vibe Coding 到底改变了什么我的总结是它把编程从“亲手写每一行代码”变成了“定义需求、协作执行、审查结果”。Claude Code 和 Codex 是目前体验最有代表性的两个 Agent 工具前者擅长项目内迭代后者擅长代码工程化审查组合使用能覆盖从零到一、从一到精的完整链路。对零基础的新人来说Vibe Coding 最大的价值是降低了进入编程世界的门槛——你不用等学完所有语法才能做项目而是可以在做项目的过程中让 AI 帮你补足知识盲区。对已有经验的程序员来说这套工作流真正值得投入的地方不是“省掉打字时间”而是把精力从重复劳动中释放出来去做需求拆解、架构决策和结果验收这些更高价值的工作。如果你读完这篇文章建议你做一件事找一个平时想做但一直没动手的小项目用 Claude Code 或 Codex 从零到一跑一遍。不要纠结第一次提示词写得不够好先跑通流程再逐步摸索如何把需求描述得更精确、如何让 AI 迭代得更稳定。Vibe Coding 是伴随大模型能力进化而来的新技能学它的方式不是看书而是实践。
最近一段时间“Vibe Coding”这个词在技术社区里几乎刷屏了。很多程序员的第一反应是这不就是让 AI 帮着写代码吗我早就在用 Copilot 了有什么新鲜的但如果你只是把它理解为“AI 自动补全的升级版”可能真的低估了这一轮变化。Vibe Coding 背后代表的是开发工作流的一次结构性调整从“人写代码、AI 补全”变成“人描述意图、AI Agent 直接操作工程”。更关键的是这套工作流不再要求你先把语法、框架、调试技巧学个遍零基础的人也可以借助 Claude Code、Codex 这类工具从一句自然语言开始完成一个可运行、可测试、可迭代的真实项目。这篇文章不打算做概念科普而是直接用 Claude Code Codex 组合带你完整体验一遍“从 AI 对话到 AI 协作开发”的实战流程。你会看到它们解决什么问题、安装配置怎么做、真实项目怎么跑通、常见报错怎么排查以及这套新工作流的边界在哪里。1. 为什么 Vibe Coding 值得程序员重新学习先说一个容易被误解的事实Vibe Coding 不是“随便聊聊就让 AI 把活干完”它是一套有方法论的人机协作开发方式。传统开发流程里一个功能从想法到上线需要经历需求分析、技术选型、编码、调试、测试、代码审查等多个环节。每个环节都依赖开发者自身的知识储备。尤其对于刚入行的新人光是把环境配好、把框架跑通就足以消耗掉一天时间。Vibe Coding 改变的是这个链条里的“编码执行”环节。它的核心思路是用自然语言描述你要什么AI Agent 负责在项目里具体执行——创建文件、编写逻辑、安装依赖、运行测试、根据报错自动修复。人和机器的关系从“操作者与工具”变成了“产品经理与执行工程师”。这带来两个直接影响第一个影响是开发门槛被拉低了。过去“写一个待办事项管理工具”需要先学 Python 或 JavaScript再学命令行和 Git现在只要你能把需求说清楚AI 就能帮你生成一个可运行的版本。第二个影响是开发效率的重心变了。对会写代码的人来说真正的耗时点往往不是“写出来”而是“改来改去”——改需求、修 bug、调样式、适配边界。Vibe Coding 时代这部分工作可以大量交给 AI人只需要负责判断方向、验收结果、纠正错误。所以我的判断是Vibe Coding 不是让程序员变懒而是把程序员的精力从“代码生产”转移到“需求定义和质量把控”上。这个转变对所有开发者都值得认真对待。2. 核心概念Claude Code、Codex 与 Agent 工作流在进入实操之前有必要把几个容易混淆的概念理清楚。2.1 什么是 Vibe CodingVibe Coding 这个词由 Andrej Karpathy 提出指的是“完全沉浸在氛围中进行编程忽略细节让 AI 发挥主导作用”。本质上它是一种以 AI 为中心的编程方式你描述需求AI 写代码你负责反馈和修正。它和传统“AI 辅助编程”最大的区别在于辅助编程中 AI 是配角代码还是你写的Vibe Coding 中 AI 是执行者你的核心工作是描述、检查和迭代。2.2 什么是 Claude CodeClaude Code 是 Anthropic 推出的终端编程 Agent 工具。它不是一个简单的聊天框而是可以读取你的项目目录、创建和修改文件、执行 shell 命令、运行测试、提交代码的完整开发助手。它最大的特点是“工作在工作目录里”。你启动claude命令后它会感知当前项目的文件结构和上下文然后通过对话处理任务。2.3 什么是 CodexCodex 是 OpenAI 推出的编程 Agent同样提供 CLI 工具和云端执行环境。它擅长代码生成、重构、bug 修复、项目脚手架搭建等任务。Codex 的交互方式很接近“让一个远程工程师帮你写代码”——你可以把整个代码仓库交给它它会在沙箱环境里执行任务并返回结果。2.4 从 AI 对话到 AI 协作开发区别在哪里普通 AI 对话工具比如网页版 ChatGPT、Claude回答完问题就结束了。它不会主动去看你的项目文件不会帮你执行命令更不会根据运行报错自动修复代码。AI 协作开发工具则完全不同对比维度AI 对话AI 协作开发Agent上下文依赖你手动粘贴自动感知项目文件执行能力只返回文本可执行命令、改文件迭代方式你复制代码再粘贴自动修改并重新运行适用场景问答、解释、片段生成完整功能开发、重构、调试Claude Code 和 Codex 就属于后者。这也是为什么说“从 AI 对话到 AI 协作开发”是一个质变。3. 环境准备与前置条件在开始安装 Claude Code 和 Codex 之前先把基础环境准备好。这部分不难但要注意版本兼容。3.1 必备环境两个工具都依赖 Node.js所以第一步是装 Node.js。# 检查是否已安装 node -v npm -v如果提示找不到命令需要先安装 Node.js 20 或更高版本。具体版本请以官方文档为准本文重点演示通用思路不绑定某一个版本号。3.2 准备一个项目目录建议新建一个干净的目录用来做后面的实战练习。mkdir vibe-coding-demo cd vibe-coding-demo git init这里建议先执行git init好处是 AI 每次修改文件后你都能用 Git 看到具体变更方便审查和回滚。这一点非常重要后面最佳实践部分会详细说。3.3 账号与网络环境Claude Code 需要一个 Anthropic 账号并开通对应订阅权限。Codex 需要一个 OpenAI 账号并具备 Codex 使用权限。如果你的团队使用企业版管理后台需要确保组织管理员已经为你的账号开启 Claude Code 或 Codex 的访问权限。这里有一个容易踩的坑很多新手安装完成后运行工具发现提示“your organization has disabled claude subscription access for claude code”这不是你操作错了而是组织管理员没有放行需要联系管理员解决。4. Claude Code 安装与基础配置Claude Code 的安装方式很简单通过 npm 全局安装即可。npm install -g anthropic-ai/claude-code安装完成后在终端输入claude启动claude第一次启动会进入登录流程按提示完成账号授权即可。登录成功后你可以在项目目录里直接和 Claude Code 对话。4.1 常用命令和操作Claude Code 启动后是一个交互式终端界面常用操作如下/help查看帮助。/status查看当前会话状态。/init让 Claude Code 在项目里生成初始配置。/clear清空当前会话上下文。CtrlC两次退出。另外Claude Code 支持非交互模式适合在脚本中调用claude -p 请告诉我当前目录下有哪些文件-p是 print 模式执行完直接输出结果并退出非常适合自动化流程。4.2 权限确认机制当你让 Claude Code 创建文件、执行命令时它会逐一请求确认。这种机制虽然多点一下鼠标但能避免 AI 做出你意料之外的操作。实际使用中我建议新手不要关闭确认等熟悉了它的行为模式再决定是否放宽。5. Codex 安装与基础配置Codex 的安装同样通过 npm 完成。npm install -g openai/codex安装完成后需要先登录codex login登录流程会打开浏览器你只需要授权即可。授权完成后运行codex进入交互式会话。5.1 常用命令和操作codex进入交互式会话可以直接描述任务。codex exec 你的任务单次执行模式适合脚本化调用。codex eval用于评估模型的代码生成效果。看一个最简单的例子codex exec 在当先目录创建一个 Python 文件 hello.py内容为打印 Hello Codex执行后Codex 会在当前目录生成hello.py并且在沙箱环境里帮你运行验证。这就是它和普通对话工具最大的不同它给出代码后还会尝试运行根据结果自我修正。5.2 与 IDE 的配合很多读者会问这两个工具是终端操作能不能集成到 VSCode 里Claude Code 支持在 VSCode 等编辑器中配置Codex 目前也有官方 IDE 扩展。具体配置方式建议直接查看官方文档不同版本差异较大这里不展开写死。终端方式其实是理解 Agent 工作流的最佳起点。6. 实战从一句话到可运行项目现在进入全文最核心的部分。我们用一个真实的开发任务完整走一遍 Vibe Coding 工作流。任务目标开发一个命令行待办事项管理工具支持添加任务、查看任务、标记完成、删除任务并且数据要持久化到本地文件。6.1 第一轮用 Claude Code 搭建项目骨架在刚才创建的vibe-coding-demo目录中启动 Claude Codeclaude然后输入第一段提示词请用 Python 创建一个命令行待办事项管理工具 todo.py支持以下功能 1. 添加任务 2. 查看所有任务 3. 标记任务为完成 4. 删除任务 数据保存到本地 JSON 文件项目结构要简洁清晰适合初学者理解。Claude Code 会开始创建文件、编写代码。你会看到它输出每一步操作并请求确认。确认后项目里会出现todo.py# 文件路径vibe-coding-demo/todo.py import json import sys from pathlib import Path TODO_FILE Path(todos.json) def load_tasks(): if not TODO_FILE.exists(): 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(title): tasks load_tasks() tasks.append({id: len(tasks) 1, title: title, done: False}) save_tasks(tasks) print(f已添加任务: {title}) def list_tasks(): tasks load_tasks() if not tasks: print(暂无任务) return for task in tasks: status [x] if task[done] else [ ] print(f{task[id]}. {status} {task[title]}) def done_task(task_id): tasks load_tasks() for task in tasks: if task[id] task_id: task[done] True break save_tasks(tasks) print(f任务 {task_id} 已标记完成) def delete_task(task_id): tasks load_tasks() tasks [task for task in tasks if task[id] ! task_id] save_tasks(tasks) print(f任务 {task_id} 已删除) if __name__ __main__: if len(sys.argv) 2: print(用法: python todo.py add|list|done|delete [参数]) sys.exit(1) command sys.argv[1] if command add: add_task(sys.argv[2]) elif command list: list_tasks() elif command done: done_task(int(sys.argv[2])) elif command delete: delete_task(int(sys.argv[2])) else: print(未知命令)这段代码的思路很直接load_tasks和save_tasks负责读写本地 JSON 文件实现数据持久化。add_task、list_tasks、done_task、delete_task对应四个核心功能。主入口通过sys.argv解析命令行参数分发到不同函数。6.2 第二轮让 Claude Code 迭代功能第一版代码已经能跑但你会发现一个设计问题删除任务后再添加新任务id可能重复因为id是按照len(tasks) 1生成的。这时候继续在 Claude Code 会话里提出修改要求当前删除任务后重新添加任务id 会重复。请修复 id 分配逻辑 改为基于已有任务的最大 id 加 1并且在删除任务时做 id 重排保持 id 连续。Claude Code 会直接修改todo.py不再是让你手动操作。它读懂问题、重写逻辑、保存文件一气呵成。这就是“协作开发”和“对话问答”之间最直观的体验差异。修复后的核心逻辑会变成def next_id(tasks): return max((task[id] for task in tasks), default0) 1 def add_task(title): tasks load_tasks() task_id next_id(tasks) tasks.append({id: task_id, title: title, done: False}) save_tasks(tasks) print(f已添加任务: {title})如果 Claude Code 没有主动思考到这个隐患你可以直接提示它。这也是 Vibe Coding 的一个重要能力你不是在给 AI 打下手而是在做代码审查和需求定义。6.3 第三轮用 Codex 做代码审查项目跑通后换一个视角用 Codex 审查一遍代码质量。codex exec 请审查当前项目中的 todo.py重点关注1. 代码风格是否符合 PEP82. 是否有潜在的异常处理问题3. 命令行参数解析是否健壮。Codex 会读取todo.py给出审查意见并直接修改代码。常见的改进点包括使用argparse替代sys.argv参数的健壮性更好。增加文件读写异常处理。明确main()函数的入口。比如参数解析部分Codex 可能会改成import argparse def main(): parser argparse.ArgumentParser(description待办事项管理工具) subparsers parser.add_subparsers(destcommand) add_parser subparsers.add_parser(add, help添加任务) add_parser.add_argument(title, help任务标题) subparsers.add_parser(list, help查看所有任务) done_parser subparsers.add_parser(done, help标记完成) done_parser.add_argument(task_id, typeint, help任务 ID) delete_parser subparsers.add_parser(delete, help删除任务) delete_parser.add_argument(task_id, typeint, help任务 ID) args parser.parse_args() if args.command add: add_task(args.title) elif args.command list: list_tasks() elif args.command done: done_task(args.task_id) elif args.command delete: delete_task(args.task_id)这个改动让命令行工具的交互体验专业了很多也展示了两个 Agent 工具的互补性Claude Code 擅长从零搭建和迭代功能Codex 擅长做代码审查和工程质量改进。6.4 运行验证修改完成后在终端实际运行验证python todo.py add 学习 Vibe Coding python todo.py add 写一篇 CSDN 实战文章 python todo.py list python todo.py done 1 python todo.py list python todo.py delete 2 python todo.py list预期输出示例已添加任务: 学习 Vibe Coding 已添加任务: 写一篇 CSDN 实战文章 1. [ ] 学习 Vibe Coding 2. [ ] 写一篇 CSDN 实战文章 任务 1 已标记完成 1. [x] 学习 Vibe Coding 2. [ ] 写一篇 CSDN 实战文章 任务 2 已删除 1. [x] 学习 Vibe Coding如果任何一步报错先看报错信息定位到具体命令行参数还是代码逻辑问题再回到对应的 AI 会话中描述错误让 Agent 修复。7. 扩展接入其他模型与团队协作很多国内开发者会遇到一个现实问题Claude Code 和 Codex 默认依赖官方模型服务但实际项目中可能有不同的模型接入需求。社区里很常见的操作是“claude code 接入 deepseek”“codex 接入 deepseek”这类配置。7.1 修改模型接入的通用思路Claude Code 和 Codex 都支持通过环境变量指定 API 地址和模型名称。以 Claude Code 为例通用做法是export ANTHROPIC_BASE_URL你的模型网关地址 export ANTHROPIC_MODEL具体模型名称Codex 类似export OPENAI_BASE_URL你的模型网关地址 export OPENAI_MODEL具体模型名称需要特别提醒的是不同模型提供方、不同网关的接口协议可能存在差异配置项的具体名称和取值必须参考你所用服务商的官方文档不要照抄网上的配置。如果你使用的是订阅制官方服务通常不需要改这些变量只有当你希望通过第三方网关或自己的模型服务时才需要这样配置。7.2 关于 Skill、Harness 等扩展能力Claude Code 支持 Skills 机制你可以把常用的项目规范、代码风格、命令模板做成 Skill让 Claude Code 在不同项目中复用。Codex 也有 Harness 机制用于定义 Agent 如何感知项目、执行任务、验证结果。这些高级特性本质上是同一个思路把团队的项目经验和工程规范沉淀成 Agent 可以读取和执行的资产。如果团队准备大规模使用 AI 协作开发这些能力值得深入研究。8. 常见问题与排查思路我整理了 Vibe Coding 实践中出现的典型问题这些是开发者最容易卡住的环节。问题现象可能原因排查方式解决方案启动时报unable to locate the codex cli binaryIDE 插件或桌面端找不到 Codex CLI 可执行文件的路径确认是否已全局安装which codex全局安装 Codex CLI或在插件设置中正确配置 codex_cli_path切换代理后报cc switch local proxy failed本地代理配置异常或代理服务不可用检查本地代理服务状态和相关配置参数核对网络配置确认代理服务正常后重试提示your organization has disabled claude subscription access for claude code企业组织管理员未开放 Claude Code 访问权限登录组织管理后台查看 Claude Code 策略联系管理员开启对应权限出现 Claude Code 529 错误服务端负载过高或配额用尽查看官方状态页和账号配额等待一段时间重试或检查订阅额度提示model is not supported this version of claude code recognizes模型名称不在当前版本支持列表中或版本过旧检查模型名称拼写、升级 Claude Code 版本使用官方支持的标准模型名或升级工具版本Codex 执行任务时只生成代码但不运行沙箱执行被限制或当前配置关闭了自动执行查看执行日志和沙箱策略调整配置或手动复制代码到项目中验证排查问题的核心思路只有一条先看错误日志再定位配置最后才考虑代码问题。不要一遇到报错就怀疑 AI 能力不行大多数问题是环境配置问题。9. 最佳实践与工程建议用 Vibe Coding 不等于放弃工程规范。恰恰相反越依赖 AI 写代码越需要严格的工程约束。9.1 版本控制必须前置用任何 Agent 工具之前先git init。AI 每完成一次修改你都能通过git diff看到它改了什么。这不仅是审查手段也是回滚手段——AI 改坏了一条命令就能还原。git add . git commit -m feat: 初始版本 git diff # 查看修改9.2 明确需求边界分段交付不要一次让 AI 做“一个完整系统”而是拆成小任务先搭骨架再补功能再修 bug再优化。每段任务独立验证通过后再进入下一轮。这和你带一个初级工程师干活是一个道理。9.3 只给 AI 最小权限Claude Code 会请求确认Codex 有沙箱模式。默认情况下不要关闭安全限制。尤其涉及文件删除、命令执行、网络请求时先看看 AI 要做什么再决定是否放行。9.4 人工审查不能缺位AI 生成的代码能跑不代表没有隐患。边界条件、异常处理、安全漏洞、性能问题这些仍然需要人来把关。AI 是效率放大器不是质量保证。9.5 选择适合的场景Vibe Coding 擅长的是从零搭建项目脚手架。编写工具脚本和自动化任务。快速实现原型验证。重构代码、修复简单 bug。生成测试用例。它不适合的场景是涉及敏感数据的生产系统核心逻辑。需求高度模糊、需要大量业务判断的任务。安全合规要求极高的场景。这些场景适合用 AI 辅助但最终决策必须由有经验的人完成。9.6 沉淀团队级 Prompt 与 Skill当团队多人使用 Claude Code 或 Codex 时把常用的需求模板、代码规范、验收标准做成统一的 Prompt 模板或 Skill能显著提高输出质量和一致性。这也是 AI 协作开发从“个人玩具”走向“团队生产力工具”的关键一步。10. 总结与下一步建议回到开头的问题Vibe Coding 到底改变了什么我的总结是它把编程从“亲手写每一行代码”变成了“定义需求、协作执行、审查结果”。Claude Code 和 Codex 是目前体验最有代表性的两个 Agent 工具前者擅长项目内迭代后者擅长代码工程化审查组合使用能覆盖从零到一、从一到精的完整链路。对零基础的新人来说Vibe Coding 最大的价值是降低了进入编程世界的门槛——你不用等学完所有语法才能做项目而是可以在做项目的过程中让 AI 帮你补足知识盲区。对已有经验的程序员来说这套工作流真正值得投入的地方不是“省掉打字时间”而是把精力从重复劳动中释放出来去做需求拆解、架构决策和结果验收这些更高价值的工作。如果你读完这篇文章建议你做一件事找一个平时想做但一直没动手的小项目用 Claude Code 或 Codex 从零到一跑一遍。不要纠结第一次提示词写得不够好先跑通流程再逐步摸索如何把需求描述得更精确、如何让 AI 迭代得更稳定。Vibe Coding 是伴随大模型能力进化而来的新技能学它的方式不是看书而是实践。
