codex中文配置从入门到使用教程

很多人在配置 Codex 中文环境时，总是卡在 API 接不上、模型报错、命令行找不到模型这些坑里。其实，只要把基础环境、CLI 安装、模型接入和 VS Code 插件这几步串起来，整个过程并不复杂。走，我们一步步来，确保你最终能跑通第一段由 Codex 生成的中文代码。

确认本地基础环境是否就绪

在开始之前，先打开终端，依次执行三行命令，缺一不可：

第一条：node -v → 查看 Node.js 版本，必须 ≥18，推荐 22.x。如果版本太低，后续安装会报错。

第二条：git --version → 检查 Git 是否安装。Windows 用户尤其要注意，没有 Git，Codex CLI 就无法读取项目结构，后续所有操作都会卡住。

第三条：npm list -g @openai/codex → 如果提示“empty”，说明还没装 CLI，直接跳到下一步安装。

这不是危言耸听，踩坑时才不会手忙脚乱。

安装并配置 Codex CLI（命令行版）

这里有两种安装方式，根据你的使用场景选择最顺手的一个。

执行 npm install -g @openai/codex，等待安装完成。之后运行 codex --version，看到版本号（如 v3.2.1）即表示成功。这种方式最省心，一次安装，全局可用。

进入你的项目根目录，依次运行：npm init -y → npm install @openai/codex --sa ve-dev → npx codex --help。这样配置的好处是，不同项目可以使用不同版本的 Codex，或搭配不同的模型服务。

注意：如果提示 EACCES 权限错误，千万不要用 sudo 强行覆盖。正确做法是：npm config set prefix ~/.local，然后再重装。

接入国内可用的中文模型服务

这一步是让 Codex 能“听懂”中文指令的关键。

第一步：注册账号并创建令牌。登录后进入「令牌管理」→「添加令牌」→ 设置名称为 codex-chinese → 额度选「无限」→ 有效期选「永不过期」→ 创建。

第二步：复制生成的 sk-xxx 密钥，以及 Base URL（固定为 https://wolfai.top/v1）。

第三步：写入配置文件。配置文件路径因操作系统而异：

Windows 路径：C:Users【当前用户名】.codexconfig.toml
macOS/Linux 路径：~/.codex/config.toml

用记事本或 VS Code 打开该文件，粘贴以下内容：

model_provider = "wolfai"
model = "gpt-5-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true

[model_providers.wolfai]
name = "wolfai"
base_url = "https://wolfai.top/v1"

这个细节很容易被忽略，导致配置一直无法生效。

在 VS Code 中启用 Codex 插件

打开 VS Code，点击左侧扩展图标，搜索 “Codex”，安装最新插件 “Codex for VS Code”。发布者是 OpenAI，注意不要装错。

安装后重启 VS Code，按 Ctrl+Shift+P（Win）或 Cmd+Shift+P（Mac），输入 “Codex: Configure Provider”，选择 “Custom Provider”，然后填入：

Base URL：https://wolfai.top/v1
API Key：刚才生成的 sk-xxx 密钥
Model：gpt-5-codex

配置完成后，可以试一下效果：右键任意 .ts 或 .py 文件，选择 “Codex: Generate Code from Comment”，输入中文注释如 “// 生成一个计算数组平均值的函数”，回车，就能看到可运行的代码。

验证配置是否生效

最后一步，验证所有配置是否真的生效：

① 打开终端，cd 进入任意含代码的项目目录；
② 执行 codex ask "用 TypeScript 写一个防抖函数，支持立即执行选项"；
③ 观察输出：如果返回的是带完整类型定义、JSDoc 注释、可直接粘贴使用的代码块，且没有出现 “Error: Unauthorized” 或 “404 Not Found” 报错，那么恭喜你，配置成功；
④ 如果卡在 loading 或返回空响应，先检查 ~/.codex/config.toml 中 base_url 末尾是否多了斜杠（正确是 /v1，错误是 /v1/）。

到这里，整个配置流程就走完了。接下来，你就可以用中文指令让 Codex 帮你写代码、改 Bug、跑测试了。如果遇到其他问题，不妨先检查一下环境变量和配置文件，大部分问题都出在这两个地方。