跳到主要内容

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 和其他偏好,并加入:

~/.codex/config.toml
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 配置参考。 遇到其他问题请参考错误排查。