我见过太多人卡在同一个地方工具装好了订阅开通了打开终端敲下claude或codex之后却不知道下一句话该说什么。他们试着问“帮我写一个登录页面”AI 真的写出来了但代码往项目里一放就报错。再问“为什么报错”AI 又给出一段修改改了之后冒出新的错误。来回折腾半小时最终结论是“AI 编程也就这样”。问题不在工具也不在读者而在一个普遍误区我们还在用“搜索引擎思维”使用 AI 编程助手。搜索引擎思维是“你问我答答案自己去试”。AI 编程思维是“你说需求AI 改代码你负责验收”。这两种思维的差距就是“会问 AI”和“会用 AI 写代码”的差距。这篇教程专门写给零基础读者但也不是只讲概念。我会把 Claude Code、Codex、Vibe Coding 三个关键词拆开讲清楚然后带你从环境安装开始用一个小任务完整跑通“用 AI 写代码”的流程再把常见的报错和排查思路整理成可以直接抄作业的清单。读完这篇你能真正理解 AI 编程的工作方式并且能独立完成一个真实的小项目。1. 这篇文章真正要解决的问题先做一个判断AI 编程工具目前的门槛已经低到不需要你懂编译原理、不需要背 API、甚至不需要精通语法。但为什么还有很多人觉得“AI 写代码不靠谱”因为大多数人缺的不是工具而是工作方法。举个例子。同样是让 AI 写一个“读取 CSV 文件并统计缺失值”的脚本只会“问 AI”的人会说帮我用 Python 写个程序。会用 AI 写代码的人会说帮我写一个 Python 脚本读取input目录下的sales.csv统计每一列的缺失值数量和缺失率把结果输出成report.csv放在output目录下。项目只用 pandasPython 3.10 以上环境。前者 AI 也能写出来但你可能要再补五六轮对话而且结果未必符合你的真实需求。后者一次就能拿到基本可用的代码。这中间的差别就是对“AI 编程工作流”的理解。这篇文章要解决的问题有三个第一理解 Claude Code、Codex、Vibe Coding 到底是什么它们之间的边界在哪里。很多人把这三个词混在一起以为它们是同一个东西实际上它们分别代表着 AI 编程的工具、代理和理念。第二掌握一套零基础也能上手的操作流程安装工具、提出需求、让 AI 执行、验证结果、处理报错。这套流程可以复用到任何 AI 编程工具上。第三避开新手最容易踩的坑。比如 Codex 扩展找不到 CLI、Claude Code 提示模型不支持、订阅权限报错、本地代理配置异常等。这些报错在官方教程里通常一句话带过但实际操作时能卡住你半天。读完这篇文章你会获得一套判断标准什么需求适合交给 AI 写什么需求应该自己写以及 AI 生成的代码如何在项目里安全落地。2. 三个关键词先搞懂它们分别是什么2.1 Vibe Coding一种新的编程方式Vibe Coding 这个词源于 AI 领域核心含义是“用自然语言描述需求让 AI 生成代码开发者主要负责意图表达和结果验收”。你可以理解为过去编程是“翻译”把人类需求翻译成机器语言Vibe Coding 是“提需求 验收”你把需求说清楚AI 负责写代码你负责检查代码是否符合需求。但这里有一个关键判断Vibe Coding 不是不写代码而是把精力从“怎么写”转移到“写什么”。对于零基础读者这意味着你不需要先背完所有语法才能做项目但你依然需要理解代码的基本逻辑否则你无法验收 AI 写出来的结果。2.2 Claude Code在终端里结对编程Claude Code 是 Anthropic 推出的命令行编程工具。它运行在终端里你输入自然语言指令Claude 可以读取项目文件、创建和修改代码、执行命令然后向你汇报结果。它的核心特点不是“对话”而是“操作”。普通聊天机器人只给你代码文本Claude Code 会直接在你的项目目录里动手创建文件、修改内容、运行测试、根据报错继续调整。这种交互方式更接近“结对编程”你负责把关方向AI 负责具体实现。Claude Code 的适用场景包括新项目脚手架搭建、已有代码的修改与重构、测试用例编写、解释陌生代码库。对零基础读者来说它在“让代码跑起来”这件事上非常友好因为 AI 会直接帮你执行命令而不是只丢给你一段代码。2.3 Codex能跑代码的编程代理Codex 是 OpenAI 推出的编程代理它和 Claude Code 定位相似都是让 AI 在真实项目环境中完成开发任务。Codex 生态里有一个值得关注的概念叫 Codex Harness可以理解成一个“让 AI 安全地执行代码”的沙箱环境AI 生成的代码先在里面运行验证再交给你确认。Codex 的常见使用方式有几种命令行工具在终端里和 AI 协作、编辑器扩展在 IDE 里使用、云端版本在浏览器里操作适合不想配本地环境的读者。新手经常会遇到一个报错unable to locate the codex cli binary. set codex cli path or ensure the elec...这个报错一般是 Codex 的编辑器扩展找不到命令行工具造成的。后面排错章节会专门处理。2.4 三者关系一句话讲清楚用做一个“番茄钟计时器”的小程序来类比Vibe Coding 是理念你说“我要一个能设置 25 分钟倒计时、到点响铃的小程序”。Claude Code 是帮你干活的助手它把计时器代码写好在终端里帮你执行然后告诉你运行结果。Codex 是替你试错的代理它不光写代码还会自己先跑一遍把运行时的错误也修掉一部分最后交给你验收。三者不是竞争关系而是可以组合使用。Claude Code 和 Codex 是工具Vibe Coding 是方法论。工具会升级方法论更持久。3. 从“会问 AI”到“会用 AI 写代码”核心工作流3.1 AI 编程四步工作流不管用 Claude Code 还是 CodexAI 编程的工作流都可以拆成四步第一步用自然语言描述需求。这一步决定了 AI 的产出方向。需求描述越具体AI 输出的代码越接近你要的结果。第二步提供项目上下文。让 AI 知道它工作在什么环境里、项目结构是什么、依赖有哪些、入口文件是哪个。没有上下文AI 只能凭经验猜测。第三步让 AI 执行并迭代。AI 写完代码后让它自己运行或跑测试根据报错继续修。这个过程是 AI 编程的核心优势人不需要手动复制粘贴代码去试错。第四步人工验收。检查功能是否符合需求、代码逻辑有没有明显问题、有没有把敏感信息写进代码。这一步对零基础读者尤其重要因为 AI 不能替你承担“代码是否安全、是否符合预期”的责任。3.2 一个零基础友好的需求描述模板我推荐新手使用下面的模板它不一定是最简短的但对于第一次接触 AI 编程的人非常管用目标我想做一个 [某功能]。 输入程序接收 [什么数据格式是什么]。 输出程序返回 [什么结果保存到哪里什么格式]。 技术使用 [语言/框架]运行环境是 [版本信息]。 约束不要引入额外依赖或可以引入需要在 requirements.txt 里说明。 验收标准[运行什么命令看到什么结果就算成功]。把这个模板用到实际场景里就变成了目标我想做一个 CSV 数据质量检查工具。 输入读取 input 目录下的 sales.csv文件编码是 UTF-8。 输出统计每列缺失值和缺失率把报告输出到 output 目录的 report.csv。 技术使用 Python 和 pandas。 约束Python 3.10 环境代码放在 main.py。 验收标准运行 python main.py 后output 目录出现 report.csv。这样的需求描述AI 基本不会跑偏。如果第一次输出的代码有问题下一步就是把报错信息复制给 AI让它在当前项目上下文里修改而不是新开对话重写。3.3 新手最容易犯的三个错误第一个错误需求太模糊。只写“帮我写个爬虫”是不够的。爬什么样的网站、需要哪些字段、反爬怎么处理、数据存到哪里这些都要说明。第二个错误把 AI 当搜索引擎。不要问“Python 怎么读 CSV”直接问“帮我在当前项目里写一个读取 CSV 的脚本”。一个是获取知识一个是完成任务。第三个错误不提供上下文就反复生成。AI 写出的代码跑不通就复制报错丢给它让它基于当前文件继续改。直接重开会话往往会让 AI 遗忘之前的背景陷入低效循环。4. 环境准备Claude Code 与 Codex 安装4.1 前置条件AI 编程工具的安装门槛并不高但仍需要满足几个基本条件第一操作系统。Claude Code 和 Codex CLI 都支持主流操作系统Windows、macOS、Linux 都可以。Windows 用户建议使用 PowerShell 或 Windows Terminal并确认系统已安装 Node.js。第二Node.js 运行环境。Claude Code 和 Codex CLI 都依赖 npm 包管理器安装。建议安装 Node.js 18.0 以上版本具体版本以官方文档要求为准。第三账号权限。Claude Code 需要 Anthropic 账号并确保账号有 Claude 的使用权限或有效的 API 访问方式。Codex 需要 OpenAI 账号。如果使用的是公司组织账号还需要确认组织已经开通权限否则可能遇到your organization has disabled claude subscription access for claude code这样的报错。第四网络环境。安装时会从 npm 仓库下载依赖包运行时需要访问对应模型服务的接口。这部分请确保你的网络环境可以正常访问所需服务。对于还没有明确方向的新手可以先从 Claude Code 入手原因是它安装简单、交互方式直观、对零基础用户更友好。4.2 安装 Claude CodeClaude Code 的安装方式以官方文档为准常见的安装命令是npm install -g anthropic-ai/claude-code安装完成后在项目目录下执行claude首次使用会进入账号验证流程。验证成功后你就进入了一个交互式终端界面。在这里可以直接用自然语言输入需求。启动后可以做一个最简单的测试。输入帮我看看这个目录里有哪些文件简单介绍一下它们的用途。如果你能看到符合实际情况的回答说明工具已经正常工作了。4.3 安装 Codex CLICodex CLI 的安装方式同样以官方文档为准。常见安装命令是npm install -g openai/codex安装完成后在项目目录执行codexCodex 首次启动会引导完成登录和权限配置。在终端里可以直接描述需求并开始任务。有一点需要提醒如果你在 VS Code 等编辑器里安装 Codex 扩展报错提示unable to locate the codex cli binary说明扩展在系统 PATH 里找不到codex命令。可以先在终端里执行codex --version确认命令已经安装如果仍然找不到可能需要重新安装或在扩展设置里手动指定 Codex CLI 的路径。4.4 关于模型和 API 配置的延伸说明在实际使用中很多人会尝试给 Claude Code 接入其他兼容 API 服务。社区里常见的做法是通过环境变量指定自定义模型端点或访问密钥。这类配置的变量名、支持列表、版本要求会随官方更新而变化所以最稳妥的做法是先查当前版本文档支持哪些配置项再按文档设置。如果你看到类似下面这种报错deepseek-v4-pro is not a model this version of claude code recognizes意思是当前版本的工具不认识你指定的模型名。通常是因为模型名拼写不对、模型不在该版本支持列表、工具版本过旧。排查思路是先检查版本再确认模型名最后升级或切换配置。不建议新手一开始就折腾自定义模型接入。先用官方默认配置跑通全流程等理解了 AI 编程的交互方式再逐步探索进阶配置。5. 实战拆解让 AI 写一个真正的工具5.1 任务设计CSV 数据质量报告为了让零基础读者完整理解 AI 编程流程我选了一个特别适合入门的任务写一个 CSV 数据质量检查脚本。为什么选这个任务第一它不需要复杂的外部服务只涉及文件和基本数据处理。第二它足够完整包含输入、处理、输出三个环节能体现 AI 编程的核心闭环。第三它可以很快验证结果不需要搭数据库或部署服务。任务目标如下输入input/sales.csv文件。输出output/report.csv包含每列字段名、非空值数量、缺失值数量、缺失率。技术Python pandas。运行方式Python 3.10 及以上环境执行python main.py。第一步确认input/sales.csv存在。没有这个文件的话可以先用 Excel 或任何文本编辑器创建一个简单的 CSV 文件包含几列数据其中故意留一些空单元格方便验证结果。5.2 在 Claude Code 中完成这个任务进入项目目录启动 Claude Codecd csv-tool claude然后在 Claude Code 终端里输入下面的需求这是一个可以直接套用的 Vibe Coding 提示词我需要一个 CSV 数据质量检查工具。 输入读取 input 目录下的 sales.csv 文件文件编码为 UTF-8。 输出统计每一列的字段名、非空值数量、缺失值数量、缺失率将结果输出到 output 目录下的 report.csv。 技术使用 Python 和 pandas代码写到 main.py。 约束Python 3.10 以上版本不引入除 pandas 外的额外依赖。 验收标准运行 python main.py 后output 目录下生成 report.csv内容包含四列字段名、非空值数量、缺失值数量、缺失率。Claude Code 会根据这个需求创建main.py设置必要的目录结构然后可能会主动询问你是否执行命令。当它尝试创建output目录时你要留意权限确认安全后再允许执行。如果一切都顺利Claude Code 会提示你运行python main.py。运行完以