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 --version

3. 登录与配置

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)) # 输出 55

Codex 不仅会生成代码，还会给出简要解释。你可以继续追问，比如要求优化性能或添加注释。

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.py

6. 实战：代码修改与调试

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.html

app.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 -v

9. 实战：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 真正成为你的高效编程伙伴。