Codex 国内安装教程：CLI 版使用指南及中文回复设置（2025 更新）

2025/9/25 Codex CLI安装教程中文设置GPT-5-CodexWSLAI编程代理工具

前段时间 OpenAI 推出的 GPT-5-Codex 更新，让这款强大的 AI 编程工具迅速走红。越来越多的开发者、程序员和 AI 爱好者开始探索 Codex 的潜力，尤其是在国内环境下，如何稳定安装和使用 Codex CLI 成为热门话题。作为一名资深 AI 工具使用者，我收到不少咨询：Codex 怎么在国内安装？Codex CLI 如何设置中文回复？今天，我来分享一篇全面的 Codex 国内安装教程 和 Codex 使用指南，涵盖从入门到高级技巧，帮助你快速上手。无论你是 Mac 用户、Linux 爱好者还是 Windows 开发者，本文都能提供实用建议。

本文约 2000 字，基于 2025 年 9 月最新版本，结合实际测试经验撰写。读完后，你将掌握 Codex CLI 安装步骤、中文回复配置 和 常见问题排查。如果你是 AI 编程新手，别担心，我们一步步来。

# 一、Codex 是什么？为什么值得国内开发者选择？

在 AI 编程时代，Codex 作为 OpenAI 的旗舰产品，正引领一场革命。它不仅仅是一个代码生成器，更是智能编码代理，能处理复杂任务，如自动化调试、代码重构和多文件协作。Codex 的核心优势在于其基于 GPT-5 模型的强大能力：最新的 GPT-5-Codex 版本能在大型复杂任务上独立运行超过 7 小时，远超传统工具。

Codex 有两种主要形式：

  • 云端版 Codex Web：通过 ChatGPT 网页直接访问，适合快速测试。
  • 本地版 Codex CLI：终端命令行工具，支持 macOS 和 Linux（Windows 通过 WSL），允许你本地读取、修改和运行代码。

与其他 AI 编程工具相比，Codex 脱颖而出。熟悉 Cursor 的用户知道，它是优秀的 AI IDE 编辑器；但如果你偏好命令行，Codex CLI 与 Claude Code 或 Gemini CLI 类似，却更稳定。为什么不选 Claude Code？ Claude 最近频繁“降智”，且容易封号，许多用户依赖镜像站访问。而 Codex 基于 ChatGPT Plus 订阅，封号风险低，且订阅费用亲民（每月约 20 美元），国内用户通过代理轻松获取。

在国内，Codex 的流行得益于其对中文的支持和低门槛。无论你是构建 Web 应用、数据分析脚本还是游戏逻辑，Codex 都能加速你的开发流程。接下来，我们深入 Codex 安装教程。

（图片保留：无）

# 二、Codex 国内安装指南：CLI 版与 Web 版详解

Codex 的安装简单高效，支持直接在 ChatGPT 网页使用，或本地部署 CLI 版。国内用户需注意网络环境：建议使用稳定代理（如魔法 TZ 工具）避免访问限制。以下是 Codex CLI 国内安装步骤，优先 macOS 和 Linux。

# 2.1 Codex CLI 终端安装：适用于 Mac 和 Linux 用户

Codex CLI 是编码代理的核心，能在本地终端唤醒 AI 助手。目前支持 macOS 和 Linux，Windows 实验性支持，推荐 WSL。直接在 Windows 安装可能遇乱码或兼容问题，浪费时间。

Codex CLI 提供两种安装方式：npm 安装（需 Node.js 环境）和 Homebrew 安装。选择一种即可，我个人用 npm，因为已有 Node.js。

# （1）npm 方式：先安装 Node.js 环境

Ubuntu/Debian Linux 用户： 运行以下命令一键安装 Node.js 22.x 版本（2025 推荐）：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
node --version
npm --version

验证版本后，安装 Codex CLI：

npm install -g @openai/codex

macOS 用户： 先安装 Xcode 和 Homebrew（如果未装）：

sudo xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node --version

然后安装 CLI：

npm install -g @openai/codex

# （2）Homebrew 方式（macOS 专属）：

brew install codex

安装完成后，创建项目目录，在终端 cd 进入，运行 codex 即可唤醒。首次使用需登录 ChatGPT Plus 账户（详见第 3.3 节）。

安装提示：国内下载 npm 包时，若遇网络慢，可切换淘宝镜像：npm config set registry https://registry.npmmirror.com。整个过程 5-10 分钟搞定。

# 2.2 云端版 Codex Web：零安装快速上手

不想本地安装？直接登录 chat.openai.com (opens new window)，选择 GPT-5-Codex 模型。输入提示如“用 Python 写一个 Web 爬虫”，即可生成代码。适合初学者测试 Codex 中文回复。

# 三、Codex CLI 使用详解：从基础到高级技巧

安装后，如何高效使用 Codex CLI？以下分享 Codex CLI 使用教程，包括 设置中文回复、模型切换和授权登录。基于我的实际经验，这些技巧能避免 80% 常见坑。

# 3.1 如何设置 Codex CLI 中文回复：永久配置指南

默认 Codex 以英文回复，但国内用户更爱中文。临时命令如“用简体中文回复”有效，但重启失效。推荐使用 Codex 记忆文件 AGENTS.md 永久设置。

全局设置步骤：

  1. 在终端执行：
    mkdir -p ~/.codex && printf 'Always respond in Chinese-simplified\n' > ~/.codex/AGENTS.md
  2. 重启终端，运行 codex，输入查询如“解释这个 Python 函数”，Codex 将始终用简体中文回应。

工作空间设置：若只限当前项目，运行 /init 生成 AGENTS.md，然后编辑添加“Always respond in Chinese-simplified”。

此配置提升 Codex 中文支持，让 AI 编程更亲切。测试：问“如何优化 SQL 查询？”，回复将全中文。

# 3.2 模型切换与查看：优先 GPT-5-Codex

Codex 支持多模型，推荐 GPT-5-Codex (high) 用于复杂任务。查看/切换命令：

/model

输出当前模型列表，选择如 /model gpt-5-codex-high。此功能帮助优化性能，国内用户注意算力负载高峰期（晚高峰）切换低配模型避封。

# 3.3 本地授权登录：开启全局代理避免封号

首次运行 codex 需登录 OpenAI 账户。国内环境建议启用 魔法 TZ 全局 Tun 模式，模拟海外 IP，降低检测风险。OpenAI 负载上升后，滥用易封号，此模式如“隐身衣”般保护你。

登录步骤：

  1. 运行 codex login，浏览器跳转 OpenAI 授权页。
  2. 输入 ChatGPT Plus 凭证，完成 OAuth。
  3. 测试：codex "hello world in JS"。

代理工具推荐：Clash 或 V2Ray，设置全局模式。图片展示 Tun 模式界面：

# 四、Codex CLI 适用人群与订阅要求

Codex CLI 仅限 ChatGPT Plus 订阅用户（或更高）。免费版无访问权。如何升级 GPT Plus？ 国内一键订阅超便捷：

GPT 一键升级：https://gptplus.org.cn/

点击链接，2 分钟完成支付与激活。官网教程详尽，新手无压力。订阅后，享无限 Codex 查询，月费低至 20 美元，性价比爆表。

图片展示升级界面：

谁适合 Codex？ 程序员、数据科学家、初学者。相比付费 IDE，Codex CLI 免费开源，结合 VS Code 插件（如 OpenAI 扩展）更强大。

# 五、Windows 用户专属：通过 WSL 安装 Codex CLI

Windows 原生支持实验性，易出乱码。推荐 WSL（Windows Subsystem for Linux） 模拟 Linux 环境，稳定运行 Codex CLI。

# 5.1 WSL 安装前提与步骤

系统要求：

  • Windows 10 21H2+ 或 Windows 11，专业/企业版（家庭版不支持 Hyper-V）。
  • CPU 启用虚拟化（BIOS 检查）。

启用功能：

  1. 控制面板 > 程序与功能 > 打开/关闭 Windows 功能。
  2. 勾选“Virtual Machine Platform”和“Windows Subsystem for Linux”。

下载 WSL 安装包（推荐 2025 版 2.5.9.0）：

  • 64-Bit：https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.x64.msi
  • ARM64：https://vip.123pan.cn/1831946356/links/wsl.2.5.9.0.arm64.msi
  • ARM64 Microsoft Store：https://vip.123pan.cn/1831946356/links/Microsoft.WSL_2.5.9.0_x64_ARM64.msixbundle

或从 GitHub 获取最新：https://github.com/microsoft/WSL/releases

安装 Ubuntu： 运行：

wsl --install -d Ubuntu-24.04

网络问题？开启代理或修改 hosts（GitHub IP：如 140.82.112.3）。查看发行版：wsl -l -o。

首次登录： 终端输入 wsl，设置用户名/密码。避免 root 用户：先从开始菜单打开 Ubuntu 一次，关闭不设密码，下次用普通用户。

# 5.2 在 WSL 中部署 Codex CLI

进入 WSL：wsl（或 PowerShell）。

安装步骤同 Linux（第 2.1 节）：安装 Node.js + npm install Codex CLI。运行 codex，无缝使用。

性能优化：WSL 2 资源分配 4GB RAM 即可，Codex CLI 轻量无负担。常见问题：若命令卡顿，检查代理；更新 WSL：wsl --update。