Codex 从零开始保姆级使用指南：安装、配置与实战代码
1. 引言：Codex 是什么
Codex 是 OpenAI 推出的 AI 编程助手，能够理解自然语言指令并生成、修改、调试代码。它基于大语言模型，支持在终端中直接对话式编程，也可以作为 IDE 插件使用。本文将从零开始，带你完成 Codex 的安装、配置，并通过多个实战代码示例掌握它的核心用法。
无论你是刚入门的新手，还是有一定经验的开发者，本文都会以保姆级的方式，一步步带你跑通 Codex 的完整工作流。
2. 环境准备
在开始之前，需要准备以下环境：
- 操作系统：Windows 10/11、macOS 或主流 Linux 发行版。
- 终端工具：Windows 推荐 PowerShell 或 Windows Terminal；macOS/Linux 使用自带终端即可。
- Node.js：建议 18.0 及以上版本，用于安装 Codex CLI。
- OpenAI 账号：用于获取 API Key 或登录授权。
下面分别介绍各环境的安装方法。
2.1 安装 Node.js
访问 Node.js 官网下载 LTS 版本并安装。安装完成后，在终端中验证：
node -v npm -v如果能看到版本号输出，说明 Node.js 安装成功。
2.2 安装 Codex CLI
使用 npm 全局安装 Codex CLI：
npm install -g @openai/codex安装完成后，验证是否成功：
codex --version3. 登录与配置
Codex 支持两种使用方式：ChatGPT 登录授权和 API Key 配置。下面分别介绍。
3.1 使用 ChatGPT 账号登录
在终端中运行：
codex login终端会输出一个登录链接，在浏览器中打开并完成授权。授权成功后，终端会显示登录成功信息。
3.2 使用 API Key 配置
如果你使用 API Key，需要设置环境变量。在终端中执行：
export OPENAI_API_KEY="sk-你的密钥"Windows PowerShell 用户使用：
$env:OPENAI_API_KEY="sk-你的密钥"为了持久化配置，建议将环境变量写入 shell 配置文件（如.bashrc或.zshrc）。
4. 第一个实战：对话式编程
完成配置后，在终端中启动 Codex：
codex进入交互式对话界面后，输入自然语言指令。例如：
写一个 Python 函数，计算斐波那契数列的第 n 项Codex 会生成如下代码：
def fibonacci(n): if n <= 0: return 0 elif n == 1: return 1 else: a, b = 0, 1 for _ in range(2, n + 1): a, b = b, a + b return b print(fibonacci(10)) # 输出 55Codex 不仅会生成代码，还会给出简要解释。你可以继续追问，比如要求优化性能或添加注释。
5. 实战：文件级代码生成
Codex 可以直接在指定目录下创建文件。先创建一个项目目录：
mkdir my-project cd my-project codex在 Codex 对话中输入：
创建一个 Python 文件 calculator.py，实现加减乘除四个函数，并包含命令行交互入口Codex 会自动创建文件并写入代码：
def add(a, b): return a + b def subtract(a, b): return a - b def multiply(a, b): return a * b def divide(a, b): if b == 0: raise ValueError("除数不能为 0") return a / b if __name__ == "__main__": while True: op = input("请输入运算符 (+, -, *, /) 或 q 退出: ") if op == "q": break a = float(input("请输入第一个数: ")) b = float(input("请输入第二个数: ")) if op == "+": print(add(a, b)) elif op == "-": print(subtract(a, b)) elif op == "*": print(multiply(a, b)) elif op == "/": print(divide(a, b))运行验证：
python calculator.py6. 实战：代码修改与调试
Codex 不仅能生成代码，还能修改现有代码。假设上面的calculator.py需要增加取余功能，在 Codex 中输入：
在 calculator.py 中增加取余函数，并在命令行交互中加入 % 运算符支持Codex 会定位到文件并自动修改，增加如下代码：
def modulo(a, b): if b == 0: raise ValueError("除数不能为 0") return a % b同时更新交互逻辑，加入%分支。这种「自然语言驱动修改」的能力，是 Codex 的核心价值之一。
7. 实战：多文件项目与重构
对于多文件项目，Codex 可以跨文件理解和修改。创建一个 Web 项目：
mkdir web-app cd web-app codex输入指令：
创建一个简单的 Flask Web 应用，包含 app.py 和 templates/index.html，实现一个待办事项列表页面Codex 会生成如下文件结构：
web-app/ ├── app.py └── templates/ └── index.htmlapp.py内容：
from flask import Flask, render_template, request, redirect app = Flask(__name__) todos = [] @app.route("/") def index(): return render_template("index.html", todos=todos) @app.route("/add", methods=["POST"]) def add(): todo = request.form.get("todo") if todo: todos.append(todo) return redirect("/") if __name__ == "__main__": app.run(debug=True)templates/index.html内容：
<!DOCTYPE html> <html> <head> <title>待办事项</title> </head> <body> <h1>待办事项列表</h1> <form method="post" action="/add"> <input type="text" name="todo" placeholder="输入待办事项"> <button type="submit">添加</button> </form> <ul> {% for todo in todos %} <li>{{ todo }}</li> {% endfor %} </ul> </body> </html>运行项目：
pip install flask python app.py浏览器访问http://127.0.0.1:5000即可看到页面。
8. 实战：测试代码生成
Codex 可以自动为已有代码生成单元测试。在项目目录中启动 Codex，输入：
为 calculator.py 中的 add、subtract、multiply、divide 函数编写 pytest 单元测试Codex 会生成test_calculator.py：
import pytest from calculator import add, subtract, multiply, divide def test_add(): assert add(2, 3) == 5 def test_subtract(): assert subtract(5, 3) == 2 def test_multiply(): assert multiply(4, 3) == 12 def test_divide(): assert divide(10, 2) == 5 def test_divide_by_zero(): with pytest.raises(ValueError): divide(1, 0)运行测试：
pip install pytest pytest test_calculator.py -v9. 实战：Git 集成与提交
Codex 可以辅助 Git 操作。在项目目录中启动 Codex，输入：
查看当前 git 状态，并生成合适的提交信息Codex 会执行git status查看变更，然后建议提交信息。你也可以让 Codex 直接执行提交：
将所有变更提交到 git，提交信息为 "feat: 添加计算器功能"Codex 会依次执行git add和git commit，完成版本管理。
10. 常用技巧与注意事项
10.1 明确指令
指令越具体，生成结果越准确。例如：
- 模糊指令：「写一个排序算法」
- 清晰指令：「用 Python 写一个快速排序算法，输入为整数列表，返回升序排列的新列表，并附带时间复杂度说明」
10.2 分步提问
复杂任务建议拆分为多个步骤，逐步与 Codex 交互，便于检查和修正。
10.3 代码审查
可以让 Codex 审查代码：
审查 calculator.py 的代码质量，指出潜在问题并给出改进建议10.4 安全注意事项
- 不要在对话中粘贴敏感信息，如密码、私钥。
- Codex 生成的代码需要人工审查后再用于生产环境。
- 涉及数据库删除、文件覆盖等危险操作时，务必确认后再执行。
11. 总结
本文从零开始，带你完成了 Codex 的安装、配置，并通过对话式编程、文件生成、代码修改、多文件项目、测试生成、Git 集成等实战示例，全面掌握了 Codex 的核心用法。Codex 是强大的 AI 编程助手，但它的输出仍需要开发者理解和把关。建议在日常开发中多实践、多总结，让 Codex 真正成为你的高效编程伙伴。