1. 引言Codex 是什么Codex 是 OpenAI 推出的 AI 编程助手能够理解自然语言指令并生成、修改、调试代码。它基于大语言模型支持在终端中直接对话式编程也可以作为 IDE 插件使用。本文将从零开始带你完成 Codex 的安装、配置并通过多个实战代码示例掌握它的核心用法。无论你是刚入门的新手还是有一定经验的开发者本文都会以保姆级的方式一步步带你跑通 Codex 的完整工作流。2. 环境准备在开始之前需要准备以下环境操作系统Windows 10/11、macOS 或主流 Linux 发行版。终端工具Windows 推荐 PowerShell 或 Windows TerminalmacOS/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 CLInpm install -g openai/codex安装完成后验证是否成功codex --version3. 登录与配置Codex 支持两种使用方式ChatGPT 登录授权和 API Key 配置。下面分别介绍。3.1 使用 ChatGPT 账号登录在终端中运行codex login终端会输出一个登录链接在浏览器中打开并完成授权。授权成功后终端会显示登录成功信息。3.2 使用 API Key 配置如果你使用 API Key需要设置环境变量。在终端中执行export OPENAI_API_KEYsk-你的密钥Windows PowerShell 用户使用$env:OPENAI_API_KEYsk-你的密钥为了持久化配置建议将环境变量写入 shell 配置文件如.bashrc或.zshrc。4. 第一个实战对话式编程完成配置后在终端中启动 Codexcodex进入交互式对话界面后输入自然语言指令。例如写一个 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, todostodos) app.route(/add, methods[POST]) def add(): todo request.form.get(todo) if todo: todos.append(todo) return redirect(/) if __name__ __main__: app.run(debugTrue)templates/index.html内容!DOCTYPE html html head title待办事项/title /head body h1待办事项列表/h1 form methodpost action/add input typetext nametodo placeholder输入待办事项 button typesubmit添加/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.pyimport 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 真正成为你的高效编程伙伴。