Codex Cli配置文档
安装Codex CLI
快速安装Codex CLI 工具。
伊莉思Code 限时提供免费的Codex试用服务，详情联系客户服务了解
首先安装Codex CLI
先前条件：确保你已经安装了 Node.js（版本22或更高）。
- 使用以下命令安装 Codex
npm install -g @openai/codex
- 验证安装是否成功：
codex --version
配置文件
codex 配置文件位于 <用户目录>/.codex 目录下。
如果该文件夹或文件不存在，请手动创建。
1.创建配置目录
使用命令行获取用户目录路径：
echo %USERPROFILE%
echo $HOME
如果 .codex 目录不存在，请创建该目录：
mkdir %USERPROFILE%\.codex
mkdir ~/.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.2-codex"
model_verbosity = "high"
network_access = "enabled"
disable_response_storage = true
personality = "pragmatic"
env_key = "OPENAI_API_KEY"
[model_providers.ylscode]
name = "ylscode"
base_url = "https://code2.ylsagi.io/openai"
wire_api = "responses"
requires_openai_auth = true
这里的
OPENAI_API_KEY是变量名，保持原样，不需要更改成KEY开始使用
现在你已经成功安装并配置了 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
否，要求我批准编辑和命令
常见错误
找不到KEY: Missing environment variable: OPENAI_API_KEY
Codex插件更新报错 "Missing environment variable: OPENAI_API_KEY" 找不到KEY
解决办法：在 ~/.codex 目录下新建/编辑 .env 文件内容
.env
OPENAI_API_KEY=<KEY密钥>
报错 401
主要原因为KEY配置不正确, 请检查key或Url配置
更新程序
要更新 Codex CLI 到最新版本，请运行以下命令：
npm update -g @openai/codex