Codex Cli配置文档
安装Codex CLI
快速安装Codex CLI 工具。
伊莉思Code 限时提供免费的Codex试用服务,联系客户服务了解 或访问 https://code.ylsagi.com 获取更多信息。
首先安装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.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "workspace-write"
personality = "pragmatic"
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
