Codex-ZH 中文版是 OpenAI Codex 的中文增强版：默认中文界面，内置中转站配置向导（Wokey / OpenRouter / 自定义），免改 config.toml 就能在国内 API Key 场景下启用 Browser、Chrome、Computer Use 等本地能力。
当前开发版的底层基线为 ChatGPT 26.715.31925（内置 Codex CLI 0.145.0-alpha.18），Windows x64、macOS Apple 芯片与 Intel x64 使用同一版定制内核。项目名称继续保留为「Codex-ZH 中文版」。
若想在手机上看进度、批命令、接管任务，或者生成只读链接分享协作过程，可以安装独立开源项目 focuxdot/CXX（装在现有 Codex / Claude Code 旁即可，支持 ChatGPT 与 Claude Code）。
关键词：Codex 中文版、Codex 汉化、Codex 国内怎么用、Codex 中转站配置、Codex Windows 安装包、Codex Mac 版、Browser / Computer Use 地区不可用。远程控制与会话分享请参考 CXX。
不需要手动改 config.toml，也不需要理解 provider、wire_api 这些配置项。下载、安装、填 Key、测试连接，然后启动 Codex。
| 需求 | Codex-ZH 中文版的处理方式 |
|---|---|
| 想让 Codex 默认显示中文 | 安装后默认启用简体中文界面 |
| 想接入中转站 | 提供 Wokey、OpenRouter、自定义中转站模板 |
| 不会改配置文件 | 首次启动进入配置向导，填地址、Key、模型名即可 |
| 怕配置被覆盖 | 写入前自动备份，只合并 Codex-ZH 中文版管理的字段 |
| Browser / Computer Use 地区不可用 | 内置本地能力配置，让入口可见、可安装、可启用 |
| 人不在电脑前 | 手机远程看进度、批命令、随时返工 |
| 想把会话分享给别人看 | 生成只读围观链接，点开即看 |
当前最新版：v0.6.0
| 你的系统 | 下载哪个版本 |
|---|---|
| Windows 10 / Windows 11（64 位） | 暂不提供，敬请等待 |
| macOS（Apple 芯片 / arm64） | 下载 Codex-ZH 中文版 0.6.0 macOS arm64 安装包 |
| macOS（Intel / x64，macOS 12+） | 下载 Codex-ZH 中文版 0.6.0 macOS Intel x64 安装包 |
macOS 版打开时如果提示文件“已损坏”或无法安装，属正常现象，按常见问题里的说明处理即可。
- 在上面的“下载”表格里下载
.exe安装包，双击安装并打开Codex-ZH。 - 在配置向导里选择模板，填写中转站地址、API Key、模型名。
- 点击“测试连接”，通过后点击“保存并启动”。
- 按你的 Mac 芯片下载对应
.dmg：Apple 芯片用mac-arm64，Intel Mac 用mac-x64（需要 macOS 12 或更新）。 - 首次打开如果提示“已损坏”或“无法验证开发者”，打开「终端」执行一次
xattr -d com.apple.quarantine "/Applications/Codex-叉叉.app"即可（原因和图形界面办法见常见问题）。 - 打开
Codex-ZH，配置向导与 Windows 相同：选模板、填地址和 Key、测试连接。 - 想用手机远程 / 会话围观：安装独立开源项目 focuxdot/CXX（装在现有 Codex 旁即可，支持 ChatGPT 与 Claude Code）。
macOS 版支持 Apple 芯片（arm64）和 Intel（x64，macOS 12+）。
Wokey 模板会预填公开测试 Key，方便第一次验证流程。长期使用或生产使用，请换成自己的中转站 Key。
如果你通过 CC-switch 等外部工具切换模型，不希望 Codex-ZH 中文版启动时打开中转站配置向导，可以在弹窗里勾选“以后不再显示这个配置弹窗”并点击“跳过本次”。启动器也支持 CodexZhLauncher.exe --skip-config 跳过本次配置向导；需要重新打开配置时，使用开始菜单里的“Codex 中转站配置”。
Codex 高效办公实战课，原创“问补做”套路 · 真实办公案例。
先从教程总入口开始看：Codex-ZH 中文版办公实战教程第一季。
大纲参考快刀青衣《Codex办公实战课》，GPT-5.5 × Opus 4.8 共创完成。
| 教程 | 主题 |
|---|---|
| 01 | 开箱即用：整理混乱文件夹 |
| 02 | 快速提案：散装资料变方案 |
| 03 | 数据清洗：乱报名表变统计数据 |
| 04 | 高效设计：一句想法变 PPT 初稿 |
| 05 | 从零造工具：CSV / Markdown 本地转换器 |
| 06 | 批量处理：一堆活动截图一次整理好 |
| 07 | 知识点到短视频：会员积分讲得不生硬 |
| 08 | 长素材到高光：直播回放拆成剪辑清单 |
| 原版 Codex | Codex-ZH 中文版 |
|---|---|
 |
 |
| 部分地区会显示 Browser 不可用。 | 内置浏览器可以正常开启。 |
| 原版 Codex | Codex-ZH 中文版 |
|---|---|
 |
 |
| Computer use / Chrome 控制可能被地区限制挡住。 | 可以开启“任意应用”和 Google Chrome。 |
如果你不熟悉这些字段，可以按下面理解：
| 字段 | 填什么 |
|---|---|
| 中转站地址 | 服务商给你的 API 地址，例如 https://api.wokey.ai 或 https://openrouter.ai/api/v1 |
| API Key | 服务商后台复制出来的 Key |
| 模型名 | 服务商支持的模型名，例如 auto、openai/gpt-4.1、gpt-4.1 |
高级字段默认不用管。Codex-ZH 中文版会自动使用当前 Codex Desktop 需要的 responses 协议。
Codex-ZH 中文版会写入官方 Codex 配置目录里的 config.toml，但写入前会先备份。
它只管理这些内容：
- 当前模型
- 当前 provider
- 中转站 Base URL
- 中转站 API Key
- Codex 桌面的对话详情显示方式
你的其它 Codex 设置会保留。
可以。Codex-ZH 中文版的目标用户就是普通用户。你不需要知道 config.toml 在哪里，也不需要理解 model_provider。
可以先用 Wokey 模板里的公开测试 Key 验证流程。长期使用建议换成自己的 Key。
Codex-ZH 中文版会让入口可见、可安装、可启用，并内置必要的本地能力配置。Chrome 控制仍然需要你本机安装 Chrome，并按界面提示连接浏览器扩展。
macOS 安装包目前是 ad-hoc 签名、未经 Apple 公证（项目不依赖 Apple 开发者账号）。先把 Codex-ZH 拖进「应用程序」，然后二选一：
- 终端法（最稳）：打开「终端」执行
xattr -d com.apple.quarantine "/Applications/Codex-叉叉.app"，之后正常双击打开。 - 图形界面法：先双击一次
Codex-ZH（会被拦，点「完成」），再到「系统设置 → 隐私与安全性」往下拉，点「已阻止 Codex-ZH…」旁边的「仍要打开」。
只影响首次启动，不影响功能。（macOS Sequoia 起，未公证脚本无法再靠双击 .command 解隔离，故已移除该辅助文件。）
不会。API Key 写入你本机的 Codex 配置文件。日志和错误提示不应该输出完整 Key。
不会明文经手任何服务器。手机与电脑之间端到端加密，中继只转发密文；中继服务器也可以按文档部署到你自己的 Cloudflare 账号。该能力由独立开源项目 focuxdot/CXX 提供，不装 CXX 时电脑上没有任何相关进程；详细安全设计见 CXX 的 PROTOCOL.md。
不会。围观链接是单会话只读：观众不能发消息、不能批命令、看不到你其他会话与审批内容。权限判定在你电脑端的设备记录上，链接随时可撤销，撤销即全场断线。
通常是下面几类原因：
- API Key 填错。
- Base URL 少了
/v1，或服务商地址不兼容。 - 模型名不存在，或账号没有开通该模型。
- 中转站暂时不可用。
配置器会尽量给出能操作的提示，比如“检查 API Key”或“检查 Base URL”。
Codex-ZH 中文版是在原版 Codex 的基础上做配置和资源定制：默认中文、预置中转站配置向导、调整本地能力入口的可用性。手机远程与会话围观能力已独立为开源项目 focuxdot/CXX，不再内置于本项目；需要这些能力时请安装 CXX（装在现有 Codex 旁即可，支持 ChatGPT 与 Claude Code）。
源码仓库只保存这些定制脚本和配置，不直接提交官方 Codex 的安装包或二进制文件。
项目不做这些事：
- 不破解官方账号。
- 不绕过官方认证、授权或 attestation。
- 不提供公共模型中转服务。
- 不把第三方私有 API Key 打进安装包。
开发者和贡献者请看 CONTRIBUTING.md，发布边界请看 OPEN_SOURCE_READINESS.md。