Documentation Index
Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
Use this file to discover all available pages before exploring further.
在 Codex 中接入 LLMEasy，需要配置自定义模型提供商和 API Key。base_url 必须填写为 https://www.llmeasy.ru/v1，协议为 OpenAI Responses。
前置条件
- 已安装 Node.js
- 已获取 LLMEasy API Key（注册并获取 (
https://www.llmeasy.ru/register)）
配置前请先清除 OpenAI 相关环境变量，避免它们覆盖 config.toml 或 auth.json 中的设置。需要清除的变量包括：
OPENAI_API_KEYOPENAI_BASE_URL
macOS / Linux 执行：unset OPENAI_API_KEY
unset OPENAI_BASE_URL
Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")
安装 Codex
npm install -g @openai/codex
配置步骤
自动配置
通过 CC-Switch 配置
手动配置
你可以直接运行 LLMEasy 提供的自动配置脚本。它只负责写入 LLMEasy provider 配置，不替代页面上方的安装前置条件。脚本需要 Node.js。如果你没有显式传入 API Key 或模型，脚本会按工具能力提示你交互输入。按你的操作系统执行对应步骤。你只需要执行其中一项。如果你使用 macOS / Linux
curl -fsSL https://www.llmeasy.ru/install-codex-provider.sh | bash
如果你使用 Windows
iwr https://www.llmeasy.ru/install-codex-provider.ps1 -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"
这条接入路径由 CC Switch 接入文档 统一维护。直接查看 CC Switch 中的 Codex 配置步骤。通过 CC Switch 完成配置后，再回到本页继续参考启动、验证或生效说明。 从模型广场复制模型 ID
打开 LLMEasy 模型广场 (https://www.llmeasy.ru/pricing)，复制 Codex 分组下当前可用的模型 ID。下文示例中的 YOUR_CODEX_MODEL_ID 都应替换为这个值。
确认配置文件位置
手动配置需要同时修改 Codex 的 config.toml 和 auth.json。| 系统 | config.toml | auth.json |
|---|
| macOS / Linux | ~/.codex/config.toml | ~/.codex/auth.json |
| Windows | C:\Users\YOUR_USER\.codex\config.toml | C:\Users\YOUR_USER\.codex\auth.json |
编辑 Codex 配置文件
打开 config.toml（不存在则新建）。这里的配置只适用于手动修改 ~/.codex/config.toml。如果你使用 CC Switch 配置 Codex，请严格按照 CC Switch 接入文档 操作，不要直接复制这里的信息去替换 CC Switch 管理的配置。 model_provider = "llmeasy"
model = "YOUR_CODEX_MODEL_ID"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.llmeasy]
name = "LLMEasy"
base_url = "https://www.llmeasy.ru/v1"
wire_api = "responses"
requires_openai_auth = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
写入 Codex 认证文件
打开 auth.json（不存在则新建）。写入以下内容（YOUR_API_KEY 替换为你的 LLMEasy API Key）：{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
重启终端中的 Codex
修改 config.toml 或 auth.json 后，请结束当前 Codex 进程，并在新终端会话中重新启动。
配置参数说明
| 参数 | 说明 |
|---|
model_provider | 当前默认使用的模型提供商标识，需要与 [model_providers.llmeasy] 中的 llmeasy 保持一致 |
model | Codex 启动后默认使用的模型 ID，请填写从模型广场复制的 Codex 分组模型 |
model_reasoning_effort | 模型推理强度，可按需要设置为 low、medium 或 high |
disable_response_storage | 禁用响应存储，建议保持为 true |
name | 提供商显示名称，可保持为 LLMEasy |
base_url | LLMEasy 的 Codex / OpenAI-compatible 协议入口，必须带 /v1 |
wire_api | Codex 使用的 API 协议，保持为 responses |
requires_openai_auth | 使用 Codex 的 OpenAI 认证文件读取 API Key，保持为 true |
1M 上下文配置
如果你使用支持长上下文的 Codex 分组模型，建议保留以下两项配置：model_context_window = 1000000
model_auto_compact_token_limit = 900000
| 参数 | 作用 |
|---|
model_context_window | 将可用上下文窗口设置为 1,000,000 tokens |
model_auto_compact_token_limit | 接近上限前提前触发压缩，减少对话直接撞满上下文的概率 |
验证配置
启动后，向 Codex 发送一条测试消息，确认收到正常回复即表示配置成功。
如遇到连接问题，请检查：
base_url 是否填写为 https://www.llmeasy.ru/v1wire_api 是否保持为 responsesmodel 是否为从模型广场 (https://www.llmeasy.ru/pricing)复制的 Codex 分组模型 ID~/.codex/auth.json 中的 OPENAI_API_KEY 是否为你的 LLMEasy API Key- 是否有旧的
OPENAI_API_KEY 或 OPENAI_BASE_URL 环境变量在干扰配置
