从零开始用 Codex 和 Claude Code：一篇写给完全不懂代码的人的上手指南

这篇文章假设你从来没写过代码，甚至没打开过”终端”这个黑框框。 读完并跟着做完，你会拥有一个能真正动手的 AI 助手——不是聊天框里给你贴代码让你自己复制，而是它直接在你电脑上建文件、改内容、跑命令、看到报错自己修。

全文约 40 分钟，动手部分约 20 分钟。建议边读边做，不要先通读。

一、先搞懂：它和 ChatGPT 到底差在哪

很多人第一次听说 Claude Code 或 Codex，反应是”这不就是能写代码的 ChatGPT 吗”。

不是。差别大到需要换一套心智模型。

普通聊天 AI 是”军师”：你描述问题，它给你一段方案或代码，你负责把它搬进现实。中间所有的复制、粘贴、保存、运行、看报错、再回来问——全是你的活。

Codex / Claude Code 是”能动手的实习生”：你把一间办公室（你电脑上的某个文件夹）交给它，它能自己打开文件看、自己改、自己运行、自己看结果对不对、不对就再改。你只需要提需求和验收。

这个差别带来三个后果，先记住：

1. 它需要一个”工作目录”——一个具体的文件夹。它默认只在这个文件夹里活动，看不见也改不了外面的东西。
2. 它会请求权限——“我要改这个文件，可以吗？""我要运行这条命令，可以吗？“这不是啰嗦，这是安全阀。
3. 它跑在终端里——那个黑框框。这是唯一一道门槛，但真的只需要学 5 分钟。

二、准备工作：终端 5 分钟速成

如果你已经会用终端，直接跳到第三节。

2.1 终端是什么

终端就是用打字代替点鼠标的一个窗口。你点”新建文件夹”，等价于在终端里敲 mkdir 文件夹名。仅此而已，没有更玄的东西。

2.2 怎么打开

• macOS：按 Command + 空格，输入 terminal，回车。（更好用的替代品是 iTerm2 或 Ghostty，但内置的完全够用。）
• Windows：开始菜单搜 Windows Terminal，打开它。

打开后你会看到类似这样一行，最后有个闪烁的光标：

wangjinlong@MacBook-Pro ~ %

这行叫提示符，~ 表示”我现在在你的用户主目录”。光标处就是你打字的地方。

2.3 只需要记住 4 条命令

一个救命技巧：在终端里想指定某个文件夹，不用手打路径——直接把 Finder / 资源管理器里的文件夹拖进终端窗口，路径会自动填好。

另一个救命技巧：终端里粘贴用 Command + V（Mac）或 Ctrl + Shift + V（Windows Terminal）。粘贴密码时看不到任何字符是正常的，不是卡住了。

2.4 建一个练习用的文件夹

后面所有操作都在这里进行，别直接拿重要项目练手：

mkdir ~/ai-practice
cd ~/ai-practice

第一行建了个叫 ai-practice 的文件夹放在主目录下，第二行走进去。敲完 pwd 确认一下，应该显示 /Users/你的用户名/ai-practice。

好了，终端部分结束。你已经会了 90% 会用到的操作。

三、装哪个？先做选择题

Codex 和 Claude Code 是两家公司做的同类产品：OpenAI 的和 Anthropic 的。功能高度重叠，但账号体系完全独立——你需要为哪一个付费，取决于你已经在为谁付费。

3.1 费用现状（2026 年 7 月）

两边都是订阅制：你买的是套餐，编程工具包含在里面，不用另外付钱。

Claude Code —— 含在所有 Claude 付费套餐里，和网页版 Claude 共用同一份额度。

Codex —— 含在 ChatGPT 套餐里，本地和云端共用一份额度。

⚠️ 三个容易搞错的点：

1. ChatGPT 的 Go / Plus / Pro 都没有年付，只有 Business 和 Enterprise 能年付；Claude 的 Pro 是有年付折扣的。
2. ChatGPT Pro 现在是双档（$100 和 $200）。很多老教程写「Pro = $200」，那是旧信息。
3. 两边入门档都是 $20/月，正好可以直接横向比：这 $20 该买 Claude Pro 还是 ChatGPT Plus，取决于你更常用哪家的网页版——因为额度是和网页聊天共享的。

用量怎么算：两边都是每 5 小时一个滚动窗口，用超了就得等下一个窗口，Codex 那边可能还叠加周限制。所以跑长任务前先用 /usage 看一眼余量，别在关键时刻断粮。

也可以两边都改用 API Key 按量付费，但对新手不推荐——没有额度上限，意味着账单也没有上限。

3.2 决策树

我的建议，一句话版本：先装你已经订阅的那家，把工作流跑顺。等你真的每天都在用了，再考虑要不要花第二份钱。同时订两家对新手是浪费——瓶颈在你的提问能力，不在工具。

四、安装 Claude Code

4.1 装

macOS / Linux，复制这一行到终端，回车：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

也可以用包管理器（brew install --cask claude-code / winget install Anthropic.ClaudeCode），但这两种方式不会自动更新，上面的官方脚本会在后台自动升级，更省心。

关于 Node.js：官方安装方式不需要你先装 Node.js。网上很多老教程会让你先装 Node，那是过时信息。只有走 npm install -g @anthropic-ai/claude-code 这条路才需要 Node 22+。

装完关掉终端重开一次，然后验证：

claude --version

能打印出版本号就成了。如果提示 command not found，重开终端；还不行就运行 claude doctor 做个体检。

4.2 首次登录

cd ~/ai-practice
claude

第一次运行会自动弹浏览器让你登录。用你的 Claude.ai 账号登进去，终端里出现 Login successful 即可。

如果浏览器没自动打开，按 c 复制登录链接手动打开；如果网页给了一串 code，粘回终端的提示处。

4.3 认识界面

进去之后就是一个输入框。三个特殊符号先记住：

• 行首打 / —— 调用命令（比如 /help）
• 行首打 ! —— 直接执行一条终端命令，结果会进入对话
• 任意位置打 @ —— 引用文件，会弹出路径自动补全

退出：/exit，或按两次 Ctrl + C。

五、安装 Codex

5.1 装

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

包管理器版本：brew install --cask codex 或 npm install -g @openai/codex。

验证：

codex --version

升级用 codex update。

5.2 首次登录

cd ~/ai-practice
codex

选 Sign in with ChatGPT，走浏览器登录流程。也可以直接跑 codex login。

如果你在没有浏览器的环境（比如远程服务器），用 codex login --device-auth 走设备码。

注意：用 API Key 登录（codex login --with-api-key）会切换成 API 计费，而不是消耗你 ChatGPT 套餐里的额度，而且一部分云端功能不可用。新手请走 ChatGPT 登录。

5.3 界面差异

Codex 的启动屏会提示 5 个核心命令：/init、/status、/permissions、/model、/review。

一个重要区别：Codex 里引用文件用 /mention 路径，不是 @。这是新手最容易踩的不一致点之一。

六、跑通第一个需求

现在开始真正有意思的部分。两个工具的操作逻辑几乎一样，下面用 Claude Code 演示，Codex 的差异我标在括号里。

6.1 一轮完整对话长什么样

注意第 ⑤ 步——很多教程会漏掉它，但它恰恰是「AI 做出来的东西能不能用」的分水岭。下一节专门讲。

6.2 为什么要在你验收之前，先让 AI 自己查一遍

先说现象：AI 写完代码后告诉你「已完成，功能正常」，你一打开发现手机上布局全乱了。这不是它在骗你，而是刚写完东西的它，是这段代码最糟糕的检查者。

原因有三个，都很朴素：

• 它的上下文里塞满了「我刚才是怎么想的」，会不自觉地按自己的意图去读代码，而不是按代码的实际行为
• 它对自己刚做的决定有路径依赖，不倾向于推翻
• 它没有「用户视角」——它知道自己想实现什么，不知道你实际会怎么点

解法出奇地简单：换个人查。 让一个上下文干净、没参与写作过程的子代理，拿着原始需求去挑刺。它没有「我刚才是这么想的」这层滤镜，看到的就是代码本身。

怎么做

最省事的办法，就是在需求后面加一句话：

做完之后，派一个子代理复查一遍：
对照我最初的需求逐条核对，找出没做到的、做错的、和边界情况没考虑的。
把问题列出来，然后自己修掉，修完再告诉我。

两边也都有内置的现成命令：

• Claude Code：/code-review 评审当前改动，可以带 --fix 让它直接修；子代理放在 .claude/agents/，你可以固化一个「QA 挑刺员」长期复用
• Codex：/review 评审改动；配置里把 approvals_reviewer 设成 auto_review，越界请求会自动交给评审代理；在 GitHub 的 PR 里评论 @codex review 也能触发

这就是「Loop 工程」

你可能已经看出来了——④ 写 → ⑤ 查 → 有问题就回到 ④ 改 → 再查，这是一个循环。

这个模式有个名字，叫 Generator–Critic（生成者 — 批评者），是 AI 工程里最基础、也最有效的一个套路。它的三个要素是：

1. 生成者：负责产出（写代码、写文案、做设计）
2. 批评者：负责挑错，而且必须和生成者分开——分开的是「上下文」，不是「模型」，同一个模型开一个干净的新会话就够了
3. 停止条件：什么时候算过关。这一条最容易被忽略，但没有它，循环要么停不下来，要么第一轮就草草结束

为什么它有效？因为判断对错，比从零做对，要容易得多。这在人类协作里也一样：写文章的人看不出自己的错别字，但换个人一眼就发现。AI 只是把这个规律又演示了一遍。

这套东西可以往上叠，也是所谓「多智能体协作」的起点：

• 最简单：一个生成者 + 一个批评者，循环 1~2 轮（新手用这个就够了）
• 进一步：多个批评者从不同角度看（一个查功能对不对，一个查安全，一个查体验），少数服从多数
• 再进一步：批评者本身也被评估，防止它乱挑刺、把对的说成错的

⚠️ 但别一上来就搞复杂的。加一个批评者，收益最大；加到第三个，边际收益就很小了，额度倒是烧得飞快。 新手阶段，「做完让它自己查一遍」这一句话，已经能拿走这套方法八成的价值。

6.3 动手：做一个个人主页

确保你在 ~/ai-practice 目录下，启动工具，然后输入：

帮我做一个单页个人主页，纯 HTML + CSS，不要用任何框架。
包含：头像占位、姓名、一句话介绍、三个作品卡片、底部联系方式。
风格要干净、留白多、移动端也要好看。
做完告诉我怎么在浏览器里打开看。

按回车。接下来你会看到：

1. 它开始思考（会显示思考过程，按 Ctrl + O 可以展开细节）
2. 它请求创建文件的权限——弹出选项让你选 Yes / No
3. 选 Yes，它写文件
4. 它告诉你结果和打开方式

第一次会有点震撼——它是真的在你硬盘上建了文件，不是在跟你描述。

打开看看：

open index.html

（Windows 用 start index.html）

6.4 关键：迭代，而不是重来

看到效果不满意，不要关掉重开、不要重新描述一遍需求。直接接着说：

卡片之间的间距太挤了，加大一倍。
另外顶部加一个吸顶导航栏，滚动时半透明。

它记得刚才做了什么，会在原基础上改。这就是”实习生”和”军师”的区别。

提需求的三个技巧：

• 说清”什么样算做对了”，而不只是”做什么”。比如”手机上打开不能出现横向滚动条”比”要响应式”有用得多。
• 一次只改一件事。同时提五个要求，它容易顾此失彼，你也难判断是哪一步出的问题。
• 不满意就说”回退”。Claude Code 有 /rewind 可以把代码和对话一起回滚到之前的检查点。

七、让它记住你的规矩：CLAUDE.md 和 AGENTS.md

用了几天你会发现一个烦人的事：每次开新对话，都要重新交代一遍”我这个项目用什么技术""注释写中文""别自作主张加依赖”。

解决办法是在项目文件夹里放一个说明文件，工具每次开工前会自动读它。

• Claude Code 读 CLAUDE.md
• Codex 读 AGENTS.md

7.1 自动生成

两个工具都有同一个命令：

/init

它会自己把项目扫一遍，生成一份初稿。你再手动改。

7.2 该往里写什么

写规矩，不写知识。它已经知道 HTML 怎么写，不需要你教。它不知道的是你的偏好：

# 项目说明

## 这是什么
我的个人网站，纯静态，部署在 Vercel。

## 硬性要求
- 所有注释和文档用中文
- 不要引入任何 npm 依赖，保持零构建
- 改完 CSS 后必须自己检查移动端断点（375px / 768px）
- 不要动 /assets 目录下的图片

## 我的偏好
- 改动尽量小，不要顺手重构无关代码
- 不确定的地方先问我，不要猜

7.3 两个文件的层级规则（这里两家不一样）

Claude Code：从当前目录一路向上找到根目录，把沿途所有 CLAUDE.md 拼接起来一起用。

• ~/.claude/CLAUDE.md —— 你的全局偏好，所有项目生效
• ./CLAUDE.md 或 ./.claude/CLAUDE.md —— 项目规矩，提交进版本库给团队共用
• ./CLAUDE.local.md —— 只有你自己用的，记得加进 .gitignore

Codex：全局层读 ~/.codex/AGENTS.md，项目层从项目根向下走到当前目录，逐级拼接，越靠近当前目录的越靠后、优先级越高。

实用提示：如果你两个工具都在用，Codex 有个 /import 命令可以导入 Claude Code 的配置，不用手抄一遍。

八、最重要的一课：权限和沙箱

这是整篇教程里唯一你必须认真读的部分。前面搞错了大不了返工，这里搞错了可能丢数据。

AI 会犯错。它可能在你没细看的情况下删掉一个它认为”没用”的文件。权限机制就是防这个的。

8.1 Claude Code 的权限模式

按 Shift + Tab 循环切换，状态栏会显示当前模式：

--dangerously-skip-permissions 就是 bypassPermissions，名字里的 “dangerously” 是认真的。网上很多教程教你加这个参数图省事——不要在你的真实电脑上这么干。

你还可以在 .claude/settings.json 里预设黑白名单，比如永久禁止读取密钥文件：

{
  "permissions": {
    "allow": ["Bash(npm run test *)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)", "Bash(curl *)"]
  }
}

8.2 Codex 的两套控制

Codex 把这件事拆成了正交的两层，理解了就不会绕：

沙箱（能碰到什么）：

• read-only —— 只能看
• workspace-write —— 能在工作区内改文件、跑常规命令（默认）
• danger-full-access —— 无限制

审批（什么时候停下来问你）：

• untrusted —— 谨慎，动不动就问
• on-request —— 需要越界时才问（交互式默认）
• never —— 不问（只适合自动化脚本）

界面上把常用组合打包成了三档：Ask for approval（默认，= workspace-write + on-request）、Approve for me（边界相同，越界请求交给自动评审）、Full access（= danger-full-access + never）。后两档默认藏起来，要去 Settings > General > Permissions 里开。

会话中用 /permissions 切换。

8.3 三条硬规矩

1. 前两周老老实实用默认模式。多按几次 Yes 花不了多少时间，看清它要干什么才是重点。
2. 在 Git 仓库里干活。哪怕你不懂 Git，也先跑一句 git init，再跑 git add -A && git commit -m "初始版本"。这样任何时候都能一键回到干净状态。
3. 不要把 AI 指向你的整个主目录。工作目录越小越好，它看不到的东西就毁不掉。

九、日常工作流：5 个能拉开差距的习惯

装好只是起点。真正决定效果的是这几个习惯。

9.1 让它先给方案，再动手

复杂需求直接开干，容易跑偏一大截才发现方向错了。

• Claude Code：/plan 你的需求，或按 Shift + Tab 切到 plan 模式
• Codex：/plan

它会先输出一份计划让你确认，你批准了才执行。改一句话的计划，比改一百行代码便宜得多。

9.2 管住上下文

AI 的”记忆”是有容量的，装满了会变笨、变慢、变贵。

• 换话题就 /clear——开一个全新的干净对话，这是最有效的一招。很多人抱怨”用着用着变傻了”，根因就是从来不清
• 同一话题聊太久就 /compact——把之前的对话压缩成摘要，保留主线
• Claude Code 里 /context 能看到一张彩色网格图，直观显示当前上下文被什么占满了

9.3 频繁提交

每完成一个能用的小功能就提交一次：

git add -A && git commit -m "加了导航栏"

这是你的存档点。AI 把事情搞砸时，git checkout . 一键回到上一个存档。没有存档点的 AI 编程等于走钢丝不系安全绳。

9.4 选对模型和”用力程度”

两边都支持按任务难度切换：

Claude Code —— /model 切换：

• sonnet —— 日常编码，快
• opus —— 复杂推理（官方推荐的默认起点）
• fable —— 最难、最长的任务
• haiku —— 简单杂活，省额度

再用 /effort 调用力程度：low / medium / high / xhigh / max，默认 high。

Codex —— /model 切换：

• gpt-5.6-sol —— 旗舰，最强（默认，配 medium 推理强度）
• gpt-5.6-terra —— 日常平衡款
• gpt-5.6-luna —— 快且便宜

推理强度同样有 minimal 到 xhigh 多档。

提醒：如果你在别处看到 gpt-5-codex、gpt-5.1-codex-max 这类名字，那是旧版本信息，gpt-5.2 和 gpt-5.3-codex 已经废弃了。

省钱心法：简单任务用小模型 + 低 effort，卡住了再往上升。反过来做会让你的额度在下午三点就见底。

9.5 让它自己验收

不要自己当人肉测试机。把验收标准告诉它，让它自己跑：

改完后自己在浏览器里打开检查，确认三个卡片在 375px 宽度下是纵向堆叠的，
有问题就直接修，修好再告诉我。

它能跑命令、能看输出、能看截图。能自动化的验收就别手动做。

再叠一层就是 6.2 讲的批评者：让它跑完还不算完，再派个干净的子代理对照需求挑一遍刺。你只保留「人才能判断的部分」——好不好看、顺不顺手、是不是你本来想要的。

十、新手最常踩的 8 个坑

1. command not found —— 装完没重开终端。关掉重开。还不行跑 claude doctor / codex doctor。
2. 在主目录直接开工 —— 它会把整个电脑当项目扫。永远先 cd 到具体项目文件夹。
3. 不用 Git —— 出事没法回滚。哪怕不懂也先 git init。
4. 额度用光 —— 5 小时窗口，用完得等。用 /usage 查剩余。别用旗舰模型干改错别字的活。
5. 一次提十个需求 —— 结果哪个都没做好。拆开，一次一个。
6. 从不 /clear —— 上下文越堆越满，越用越傻。换话题就清。
7. 无脑加跳过权限的参数 —— 网上教程的重灾区。真实电脑上别这么做。
8. 把两个工具的命令记混 —— 引用文件 Claude Code 用 @，Codex 用 /mention；两边都有 /init，但生成的文件名不同。

十一、进阶地图：知道有这些东西就够了

下面四个概念现在不用学，但你该知道它们存在，将来需要时知道去查什么。

Skills（技能） —— 把你反复粘贴的那套步骤存成一个文件，以后打 /名字 一键调用。关键优点是不用时不占上下文。Claude Code 放在 .claude/skills/名字/SKILL.md；Codex 放在 .agents/skills/，用 $ 或 /skills 调用。

Subagent（子代理） —— 派个”分身”去干杂活，它自己看完一堆文件，只把结论带回来，不污染你的主对话。6.2 讲的「QA 批评者」就是它最值得先学的一个用法；除此之外，“把这十个文件都读一遍找出问题”这类活也很适合。Claude Code 的子代理放在 .claude/agents/，Codex 用 /agent。

MCP —— 给 AI 装”外接插头”，让它直接读写你的 Notion、数据库、监控台，不用你复制粘贴中转。两边都支持，用 /mcp 管理。注意：连接前确认你信任这个服务器，第三方 MCP 存在提示词注入风险。

Hooks（钩子） —— 定死的自动化触发器，比如”每次改完文件自动格式化""某条命令一律禁止”。和 CLAUDE.md 的区别是：CLAUDE.md 是建议，AI 可能不听；Hook 是规则，必然执行。要拦死某个动作，用 Hook 而不是写在 CLAUDE.md 里。

十二、命令速查

十三、最后：真正的门槛不在工具

装好这两个东西，大概 20 分钟。但这只是入场券。

用下来我的体会是：工具的上限很高，大部分人卡住的地方是”不会提需求”。

同样一句”帮我做个网站”，有人得到一坨垃圾，有人得到能直接上线的东西，差别在于后者说清楚了：给谁看、什么风格、参考哪个站、必须有什么、绝对不要什么、做完怎么算合格。

这套能力和写代码无关，和你能不能把脑子里模糊的想法说成一份清晰的需求有关。这恰恰是不懂代码的人也能练、甚至更容易练好的东西。

所以最后的建议只有一句：别停在教程里，今晚就找一个你真正想做的小东西，从头做到能打开为止。

文档地址（2026 年 7 月核实，网上大量中文教程引用的是已失效的旧地址）

• Claude Code 官方文档：https://docs.claude.com/en/docs/claude-code/
• Codex 官方文档：https://learn.chatgpt.com/codex/

两家迭代都很快，命令和模型名可能变化。遇到对不上的地方，以官方文档和 /help 的实际输出为准。