Codex CLI 一键配置
YiJue.ai 为已开放 Codex 能力的模型提供 OpenAI Responses 兼容接口。配置工具会
安全合并用户级 ~/.codex/config.toml,创建独立的 yijue provider,并把
YiJue.ai API Key 保存到 macOS Keychain 或 Linux Secret Service。
安装
在终端运行:
curl -fsSL https://yijue.ai/docs/install/yijue-codex-setup.py | python3 - install
工具随后会要求输入 YiJue.ai API Key。粘贴时不回显字符属于正常现象。
安装完成后,按安装器输出加载私有环境脚本并启动 Codex:
source "${CODEX_HOME:-$HOME/.codex}/yijue-api-key-env.sh"
codex
每个新终端都需要先执行一次 source。你也可以把这条 source 命令加入自己的
Shell 启动文件;不要把真实 Key 写进启动文件。
Key 不会写入 config.toml、安装状态、下载 URL、Shell 历史或命令行参数。
私有环境脚本只包含系统凭据存储的查询命令,不包含 Key。安装器会备份原始
config.toml,使用权限 0600 和原子替换,并提供安全撤销。
查看配置状态
curl -fsSL https://yijue.ai/docs/install/yijue-codex-setup.py | python3 - status
状态检查会验证 provider 字段、配置备份、环境加载脚本和系统凭据副本,不会显示 完整 Key。
撤销配置
curl -fsSL https://yijue.ai/docs/install/yijue-codex-setup.py | python3 - undo
如果 config.toml 未变化,撤销会恢复安装前的原始字节;如果文件已有外部修改,
撤销只移除仍等于安装器写入值的 YiJue 条目,并保留其他内容。
配置了什么
安装器保留现有模型、审批、沙箱、MCP 和其他偏好,并加入:
model_provider = "yijue"
[model_providers.yijue]
name = "YiJue.ai"
base_url = "https://yijue.ai/v1"
env_key = "YIJUE_API_KEY"
wire_api = "responses"
supports_websockets = true
wire_api = "responses" 是当前 Codex CLI 自定义 provider 支持的协议。
env_key 填写的是环境变量名称,不是 API Key 本身。
安装器不会自动覆盖已有 model_provider 或 [model_providers.yijue]。检测到这些
配置时会安全停止,避免改变用户已有 provider 路由。当前模型仍由你的
model = "..." 配置或 Codex 模型选择器决定;请选择 YiJue 已发布且支持 Codex
Responses 的模型。
验证
source "${CODEX_HOME:-$HOME/.codex}/yijue-api-key-env.sh"
codex
进入任意测试目录后发送一条短消息。随后在 YiJue.ai 控制台查看最近调用、Token 与费用。
如果 Codex 提示缺少 YIJUE_API_KEY,说明当前终端尚未加载环境脚本;如果提示
模型或 Responses 能力不可用,请切换到 YiJue 已发布的 Codex 模型。
参考:Codex 配置参考。 遇到其他问题请参考错误排查。