Codex 配置文档

安装Codex CLI

快速安装Codex CLI 工具。
伊莉思Code 限时提供免费的Codex试用服务,联系客户服务了解 或访问 https://code.ylsagi.com 获取更多信息。

首先安装Codex CLI

先前条件:确保你已经安装了 Node.js(版本22或更高)。

  1. 使用以下命令安装 Codex
npm install -g @openai/codex
  1. 验证安装是否成功:
codex --version

配置文件

codex 配置文件位于 <用户目录>/.codex 目录下。

如果该文件夹或文件不存在,请手动创建。

1.创建配置目录

使用命令行获取用户目录路径:

echo %USERPROFILE%

如果 .codex 目录不存在,请创建该目录:

mkdir %USERPROFILE%\.codex

2.编辑配置文件

.codex 文件夹下创建或编辑配置文件:

创建或编辑 auth.json 配置KEY密钥

auth.json
{
  "OPENAI_API_KEY": "<你的API Key>"
}
请确保将 <你的API Key> 替换为你实际的 KEY密钥。

创建或编辑 config.toml 配置文件,无需修改其他内容

config.toml
model_provider = "ylscode"

model = "gpt-5.4"
model_reasoning_effort = "high"

approval_policy = "on-request"
sandbox_mode    = "workspace-write"

network_access = "enabled"
disable_response_storage = true

personality = "pragmatic"
service_tier = "fast"

env_key = "OPENAI_API_KEY"

[model_providers.ylscode]
name = "ylscode"
base_url = "https://code.ylsagi.com/codex"
wire_api = "responses"
requires_openai_auth = true
如果 key是 cr_ 开头的,请将 base_url 改成 "https://code3.ylsagi.io/openai"
这里的OPENAI_API_KEY是变量名,保持原样,不需要更改成KEY密钥。

更多配置参考官方文档 https://developers.openai.com/codex/config-basic

开始使用

现在你已经成功安装并配置了 Codex CLI,可以开始使用它来与 OpenAI 的 Codex 模型进行交互了。

在终端中cd到项目目录,然后运行以下命令启动 Codex CLI ,

文档站配置的模型可能过期,启动后使用 /model 切换到最新模型即可

codex
  Since this folder is version controlled, you may wish to allow Codex
  to work in this folder without asking for approval.
  此文件夹受版本控制,您可能希望允许Codex在此文件夹中工作,而无需征求批准。

> 1. Yes, allow Codex to work in this folder without asking for approval
    是,允许Codex在此文件夹中工作,无需征求批准
  2. No, ask me to approve edits and commands
    否,要求我批准编辑和命令

报错 401

主要原因为KEY配置不正确, 请检查 key 或 Url 配置

更新程序

要更新 Codex CLI 到最新版本,请运行以下命令:

npm update -g @openai/codex

Codex官方文档

更多参考配置查看Codex官方文档