从安装到实战,速通 Codex,零基础终极教程

关注小慧"1对1指导"软考备考

文末领取软考备考资料。

AI 编程 · 零基础教程

从安装到实战，速通 Codex，零基础终极教程

信息源：OpenAI 官方文档 / GitHub openai/codex ｜更新：2026-07-27

Codex 是 OpenAI 开源的命令行 AI 编程代理，用 Rust 构建，跑在你本地终端里，能读、改、运行代码。代码不离开你的环境，只在需要推理时把 prompt 和上下文发给模型。

简单说：一行命令装好，登录就能用，在终端里直接让它帮你改代码、写测试、查 bug。本文从零开始，5 步带你跑通。

一、装好它

Codex 支持三种安装方式，按你的系统选一种即可。

方式 1｜npm 安装（推荐，全平台）

# 需先装 Node.js 22 及以上版本npm install -g @openai/codex# 验证是否装好codex --version

方式 2｜Homebrew（macOS / Linux）

brew install --cask codex

方式 3｜独立安装脚本（macOS / Linux）

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

系统要求：macOS 12+、Linux（Ubuntu 20.04+/Debian 10+）、Windows 10+（原生或 WSL2）、内存 4GB 以上。Windows 用户建议用 WSL2，原生支持仍处实验阶段。

二、登录认证

装好后需要登录，二选一。

方式 A｜用 ChatGPT 账号登录（最简单）

codex auth login# 会自动打开浏览器，用 ChatGPT 账号授权即可# 适用：有 ChatGPT Plus / Pro / Team / Enterprise 订阅

方式 B｜用 API Key（按量付费）

# 方式一：环境变量export OPENAI_API_KEY="sk-你的key"# 方式二：交互式登录codex auth login --api-key# 查看当前登录状态codex auth status

提示：把 export OPENAI_API_KEY=... 写进 ~/.zshrc 或 ~/.bashrc，可让 key 跨终端会话生效。

三、跑第一个任务

进入任意项目目录，直接把任务交给它。

cd ~/projects/my-app# 启动交互式会话codex# 或直接带任务运行codex "Add a hello world function to main.py"

Codex 会读取你的代码、理解上下文、生成改动，并以 diff 形式展示给你确认，再决定是否应用。整个过程你始终是最终决策者。

四、三种审批模式，按需选

Codex 提供三种"放权程度"，对应不同安全等级。

模式	能做什么	适合场景
Suggest	读文件、提议改动和命令，执行前需你批准	默认模式，安全探索、代码审查、熟悉新项目
Auto Edit	自动读写文件，但运行 shell 命令前仍会询问	重构、批量改动，想盯住副作用
Full Auto	完全自主，沙盒内 + 网络禁用 + 目录隔离	修 bug、原型验证等较长任务，可放手让它跑

# 切换模式codex --auto-edit# Auto Edit 模式codex --full-auto# Full Auto 模式# 会话中也可用快捷键切换/mode

⚠️ Full Auto 会自动应用改动，仅在低风险任务或一次性分支里用。Codex 进入 Auto Edit / Full Auto 前会提醒你：当前目录是否在版本控制下。

五、5 个实战场景

场景 1｜让 Codex 解释陌生代码库

接手新项目时，直接让它给你讲明白。

codex "explain this codebase to me"

场景 2｜自动写单元测试

给某个模块补测试，省下重复劳动。

codex "Write unit tests for the auth module"

场景 3｜定位并修复类型错误

把报错甩给它，让它定位+修复。

codex "Fix the type error in src/api/handlers.ts"

场景 4｜批量补注释

给所有导出函数加 JSDoc，一次搞定。

codex "Add JSDoc comments to all exported functions"

场景 5｜重构数据库连接

把单连接改成连接池，Full Auto 放手让它改。

codex --full-auto "Refactor the database connection to use a connection pool"

六、配置与进阶

Codex 的配置文件在 ~/.codex/，支持 YAML 或 JSON 格式。

配置文件示例（~/.codex/config.yaml）

model: o4-mini # 默认模型，可改 gpt-4.1 / o3 等 approvalMode: suggest # suggest / auto-edit / full-auto fullAutoErrorMode: ask-user # 出错时询问 / 自动忽略 notify: true # 桌面通知 safeCommands: # 自动批准的安全命令 - npm test - yarn lint

也可以在 ~/.codex/instructions.md 里写自定义指令，让 Codex 按你的习惯响应（如"始终用中文回复""未明确要求不使用 git"）。

常用 flag 速查

Flag	作用
--model	切换模型，如 `codex --model gpt-4.1`
--full-auto	无需确认直接应用改动（低风险任务用）
--auto-edit	自动读写文件，命令仍需确认
--quiet	抑制非必要输出
--upgrade	升级到最新版本
--help	查看所有 flag 和子命令

日常维护命令

codex --upgrade# 升级到最新版codex auth status# 查看登录状态

七、安全与常见问题

代码会被上传吗？不会。所有文件读写、命令执行都在本地完成，只有 prompt 和上下文摘要发给模型推理。
卡住或超时怎么办？按 Ctrl+C 取消当前步骤，再让它继续；确认网络稳定。
支持其他模型吗？支持。用 --provider 切换，可选 openrouter / gemini / ollama / mistral / deepseek / xai / groq，需配置对应 API Key。
多模态输入？支持。可直接贴截图、设计图，让 Codex 据图生成或修改代码。

⚠️ 零数据保留（ZDR）组织暂不支持：Codex 依赖 Responses API 的 store 能力做内部推理，ZDR 组织无法使用 store:true，会报错。

一行命令装好，今天就开始用 Codex

回复"Codex"领取完整命令速查表 + 配置模板

从安装到实战，全流程就这些。Codex 的价值不在于"代替你写代码"，而在于把重复性、机械性的活外包出去——测试、注释、类型修复、代码解释，这些它做得又快又稳。把省下的时间留给真正需要思考的设计和决策。

本文依据：OpenAI Help Center 官方文档、GitHub openai/codex 仓库 README、opentools.ai 快速指南。
Codex 处于活跃开发中，命令和参数可能随版本调整，以官方最新文档为准。

扫码添加顾问老师

领取AI启航班0元试听+课程内部价格👇

项目管理考试动态一览

✅2026系统集成项目管理工程师（中项）：

·考试时间：2026年10月24日-27日；

·报名提醒：关注公众号预约；

·备考周期：5~6个月；

·课程详情：关注公众号联系小慧；

✅2026PMP考试时间：

·考试时间：2026年9月12日；

·准考证打印时间：预计考前一周开放；

✅2026CSPM考试时间：

·考试时间：2026年9月19日;

·准考证打印时间：预计考前一周开放；

✅2026信创考试时间：

·每月一次，可随约随考