# Codex 中文手册 > 基于 Codex CLI v0.160.1 官方文档整理的 Codex 中文手册。 - 作者：David（道雾轩） - 最后更新：2026-09-29 - 原文：https://daiw.net/manual/codex - 转载与引用：请注明出处并附原文链接（https://daiw.net/about/copyright） [Codex CLI](https://github.com/openai/codex) 是 OpenAI 出品、在你本机运行的编码 agent，以 `codex` 命令启动：在终端里阅读代码、修改文件、执行命令、调用 MCP 工具，也能用 `codex exec` 嵌入脚本和 CI 流水线。它用 Rust 编写，以 Apache-2.0 协议在 GitHub 开源（仓库 `openai/codex`）。 本手册已核对至 **Codex CLI v0.160.1**（GitHub tag `rust-v0.160.1`，2026-10-05 发布），依据官方文档与近期稳定版发布说明整理。Codex 迭代很快，具体行为请以你本机的版本为准： ```bash codex --version codex doctor # 检查安装、配置、登录与运行环境 ``` ## Codex 的几种形态 同一个 Codex 有多个使用入口。本手册以 CLI 为主，其他形态只在相关处简要提及： | 形态 | 运行位置 | 与 CLI 的关系 | | --- | --- | --- | | Codex CLI | 本机终端 | 本手册的主题，开源 | | ChatGPT 桌面应用中的 Codex | macOS、Windows（Linux 版处于预览阶段） | 图形界面的本地客户端。`codex app` 可以从终端打开它（未安装时启动安装程序），会话中输入 `/app` 可把当前会话转到桌面端继续 | | IDE 扩展 | VS Code、Cursor、Windsurf 等（Xcode、JetBrains 有各自的集成） | 编辑器侧边栏里的 Codex，不开源 | | Codex cloud | OpenAI 托管的隔离容器 | 在云端并行运行任务。CLI 中用 `codex cloud` 浏览或提交云端任务，用 `codex apply` 把任务产生的 diff 应用到本地；只支持 ChatGPT 账号登录 | 桌面应用、CLI 与 IDE 扩展读取同一个配置文件 `~/.codex/config.toml`；CLI 与 IDE 扩展还共享同一份登录缓存，在其中一处登出后，两边下次启动都需要重新登录。 ## 最快上手 ```bash # 1. 安装（macOS / Linux；Windows 与其他方式见安装页） curl -fsSL https://chatgpt.com/codex/install.sh | sh # 2. 进入项目目录启动，首次运行按提示登录（推荐 Sign in with ChatGPT） cd /path/to/project codex # 3. 在会话里为项目生成 AGENTS.md /init # 4. 在脚本或 CI 中非交互运行 codex exec "总结这个仓库的结构，列出风险最高的 5 个模块" ``` 之后的日常使用，基本就是“用自然语言描述任务，在需要时用斜杠命令调整会话”，常见套路见[常见使用场景](https://daiw.net/manual/codex/scenarios)。 ## 手册导读 **入门** - [安装、登录与升级](https://daiw.net/manual/codex/installation)——系统要求，安装脚本、npm、Homebrew 与二进制安装，登录方式与凭据存储，`codex update`、`codex doctor` 与卸载。 - [启动命令行选项](https://daiw.net/manual/codex/cli-flags)——全部子命令一览，以及模型、沙箱与审批、目录、配置覆盖等全局参数。 - [配置文件 config.toml](https://daiw.net/manual/codex/configuration)——Codex 的主要配置入口。 - [配置项速查](https://daiw.net/manual/codex/config-reference)——`config.toml` 配置项的速查表。 - [环境变量](https://daiw.net/manual/codex/environment-variables)——按用途分组的环境变量，以及 Codex 注入给子进程的变量。 - [常见使用场景](https://daiw.net/manual/codex/scenarios)——从第一次运行到 CI、代码审查、MCP、本地模型的实操套路。 **核心概念** - [沙箱、审批与安全](https://daiw.net/manual/codex/sandbox-approvals)、[AGENTS.md 项目指令](https://daiw.net/manual/codex/agents-md)、[模型与推理](https://daiw.net/manual/codex/models)。 **命令参考** - [斜杠命令](https://daiw.net/manual/codex/slash-commands)、[非交互模式 codex exec](https://daiw.net/manual/codex/exec)、[会话管理](https://daiw.net/manual/codex/sessions)、[代码审查](https://daiw.net/manual/codex/review)。 **进阶** - [命令规则 Rules](https://daiw.net/manual/codex/rules)、[MCP 集成](https://daiw.net/manual/codex/mcp)、[Skills 技能](https://daiw.net/manual/codex/skills)、[插件](https://daiw.net/manual/codex/plugins)、[Hooks](https://daiw.net/manual/codex/hooks)、[子代理](https://daiw.net/manual/codex/subagents)、[SDK 与 App Server](https://daiw.net/manual/codex/sdk-app-server)、[Codex Cloud、GitHub 与 IDE](https://daiw.net/manual/codex/cloud-integrations)。 **其它** - [更新日志](https://daiw.net/manual/codex/changelog)。 ## 与《Claude Code 中文手册》的关系 本站的[《Claude Code 中文手册》](https://daiw.net/manual/claude-code)与本手册结构基本对应，两者的很多概念可以一一对照（例如 `AGENTS.md` 之于 `CLAUDE.md`、`codex exec` 之于 `claude -p`），同时使用两款工具时可以对照阅读。 ## 想看源码怎么实现 本手册讲怎么用。想知道这些功能在源码里是怎么实现的（app-server 协议、agent 循环、工具编排、三个平台的沙箱等），可以接着读本站的[《Codex 源码解读》](https://daiw.net/manual/codex-source)。源码解读目前以 `rust-v0.158.0` 为准，各章会链接回本手册的对应页面；CLI 后续版本的变化请以本手册与官方发布记录为准。 ## 本专栏篇目 - [概览](https://daiw.net/manual/codex.md): 基于 Codex CLI v0.160.1 官方文档整理的 Codex 中文手册。 ### 入门 - [安装、登录与升级](https://daiw.net/manual/codex/installation.md): Codex CLI 的系统要求、安装方式、登录与凭据存储、升级、诊断与卸载 - [启动命令行选项](https://daiw.net/manual/codex/cli-flags.md): codex 子命令一览与全局参数、交互模式参数参考 - [配置文件 config.toml](https://daiw.net/manual/codex/configuration.md): config.toml 的位置与分层优先级、-c 单次覆盖、profile、项目信任、requirements.toml，以及常用配置段落示例 - [配置项速查](https://daiw.net/manual/codex/config-reference.md): 按主题分组的常用 config.toml 配置项，列出键名、类型、默认值与作用（基于 Codex CLI v0.158.0） - [环境变量](https://daiw.net/manual/codex/environment-variables.md): Codex CLI 读取的环境变量，以及它注入给子进程的环境变量 - [常见使用场景](https://daiw.net/manual/codex/scenarios.md): 从第一次运行到 CI、代码审查、MCP 与本地模型的实操套路 ### 核心概念 - [沙箱、审批与安全](https://daiw.net/manual/codex/sandbox-approvals.md): 沙箱模式与审批策略、常用组合与危险参数、网络访问、权限配置档、自动审查、各平台沙箱实现与 codex sandbox 测试 - [AGENTS.md 项目指令](https://daiw.net/manual/codex/agents-md.md): AGENTS.md 的发现与合并规则、覆盖文件、大小上限、备用文件名、如何确认实际加载的指令，以及写法建议 - [模型与推理](https://daiw.net/manual/codex/models.md): 可用模型与默认模型、切换方式、推理强度等参数、Fast 模式、自定义模型提供方、本地模型、Amazon Bedrock，以及计费与额度 ### 命令参考 - [斜杠命令](https://daiw.net/manual/codex/slash-commands.md): 交互会话中的全部斜杠命令（按用途分组），常用快捷键与输入技巧，以及全屏对话记录的操作 - [非交互模式 codex exec](https://daiw.net/manual/codex/exec.md): 在脚本和 CI 中运行 Codex：全部参数、默认的沙箱与审批、JSONL 事件流、结构化输出与会话恢复 - [会话管理](https://daiw.net/manual/codex/sessions.md): 会话记录的存储位置，resume、fork、archive、delete、queue 等子命令，以及相关斜杠命令与配置 - [代码审查](https://daiw.net/manual/codex/review.md): 交互模式的 /review、非交互的 codex review、审查模型配置、AGENTS.md 中的审查规则，以及 GitHub 与 GitLab 上的 @codex review ### 进阶 - [命令规则 Rules](https://daiw.net/manual/codex/rules.md): 用 .rules 文件控制哪些命令可以在沙箱外运行：文件位置、Starlark 语法、匹配与决策、测试方法以及与审批策略的关系 - [MCP 集成](https://daiw.net/manual/codex/mcp.md): 在 config.toml 中配置本地 stdio 与远程 HTTP 两类 MCP 服务器，用 codex mcp 管理服务器与 OAuth 登录，以及 codex mcp-server 移除后的替代方案。 - [Skills 技能](https://daiw.net/manual/codex/skills.md): SKILL.md 的格式与字段、Codex 从哪些目录加载技能、显式与隐式调用、内置技能与分享方式，以及如何从已弃用的自定义 prompts 迁移。 - [插件](https://daiw.net/manual/codex/plugins.md): 插件能打包的组件、codex plugin 与 marketplace 子命令、插件目录结构与清单文件，以及本地开发、测试与分发的流程。 - [Hooks](https://daiw.net/manual/codex/hooks.md): 在 Codex 生命周期的固定节点运行脚本或 MCP 工具：全部事件与触发时机、配置写法、匹配规则、输入输出约定、信任与调试，附完整示例。 - [子代理](https://daiw.net/manual/codex/subagents.md): Codex CLI 的子代理（subagent）用法，涵盖触发与切换、并发与汇总、自定义 agent 文件与 agents 配置，以及 codex agents 代理总览。 - [SDK 与 App Server](https://daiw.net/manual/codex/sdk-app-server.md): 用 TypeScript 或 Python SDK 编程控制 Codex，codex app-server 的传输方式、协议与主要方法，守护进程、codex remote-control 与 Codex Remote，codex mcp-server 移除后的迁移，以及实验性的 exec-server。 - [Codex Cloud、GitHub 与 IDE](https://daiw.net/manual/codex/cloud-integrations.md): CLI 之外的 Codex 入口，包括 Codex Cloud 与 codex cloud 命令、GitHub Action 与 PR 代码审查、IDE 扩展与桌面端、worktree，以及从 Claude Code 或 Cursor 导入配置。 ### 其它 - [更新日志](https://daiw.net/manual/codex/changelog.md): Codex CLI 最近一批稳定版（0.149 → 0.160.1）的新特性、行为变更与重要修复，整理自 GitHub Releases。