Lanjunex · 客户端接入 · 更新于
Codex CLI 如何配置 Lanjunex 第三方 API
本教程通过启动参数，为当前 Codex CLI 进程指定 Lanjunex Provider，使用 OpenAI Responses 兼容协议。先验证连接再决定是否长期保存配置，避免用一份示例覆盖你已有的完整配置文件。
https://lanjunex.com/v1，协议 responses，完整请求为 /v1/responses。不要填成 /v1/responses 作为 Base URL，也不要使用 Chat Completions 配置代替 Responses。运行前准备
- 安装对应 CLI，并先在终端运行版本命令。以下命令面向 macOS / Linux 的 Bash 或 Zsh，隐藏输入 Key 使用 Python 3；先确认
python3 --version可用。Windows 可先使用CC Switch 导入入口，不要把本页 Shell 命令直接粘进 PowerShell。 - 进入API Key 页面创建或选择有效 Key，检查其额度、过期时间与访问限制。Key 是本站密钥，不是网页登录密码或其他平台的 Key；请勿放进仓库、截图或公开聊天。
- 在模型广场查看精确 Model ID 与协议，再确认所用 Key 的实际授权目录。下面的型号是示例，不保证每把 Key 都开放；运行前替换为当前获准、支持该协议的型号。
- 选一个允许客户端读取的工作目录再启动。首次验证只发送简单文字，不要直接把私有项目交给新连接；后续文件、工具权限由你逐项决定。
运行 codex --version 确认 CLI 已安装；安装与用法见Codex CLI 官方文档。本教程适用于 CLI；其他客户端请查看完整接入指南。
仅为本次启动指定 Provider
先把 gpt-6.1-sol 替换成当前 Key 目录中获准且支持 Responses 的精确型号。确认 Python 3 可用后粘贴整段，在隐藏提示中输入本站 Key。Key 通过环境变量读取，不写进配置文本或命令字面量；
(
LANJUNEX_API_KEY="$(python3 -c 'import getpass; print(getpass.getpass("Lanjunex API Key: "))')" || exit 1
test -n "$LANJUNEX_API_KEY" || exit 1
export LANJUNEX_API_KEY
codex --model 'gpt-6.1-sol' \
-c 'model_provider="lanjunex"' \
-c 'web_search="disabled"' \
-c 'model_providers.lanjunex.name="Lanjunex"' \
-c 'model_providers.lanjunex.base_url="https://lanjunex.com/v1"' \
-c 'model_providers.lanjunex.env_key="LANJUNEX_API_KEY"' \
-c 'model_providers.lanjunex.wire_api="responses"' \
-c 'model_providers.lanjunex.requires_openai_auth=false' \
-c 'model_providers.lanjunex.supports_websockets=false' \
-c 'model_providers.lanjunex.request_max_retries=0' \
-c 'model_providers.lanjunex.stream_max_retries=0'
)-c 是本次进程的配置覆盖；env_key 填的是环境变量名，不是 Key 内容。requires_openai_auth=false 表示此 Provider 使用本站凭据。示例关闭 WebSocket、内置网页搜索与请求/流式自动重试，沿用本站现有 HTTP Responses 接入方式；具体工具能力以所选模型和接口支持为准。
启动后先核对界面中的模型和 Provider，再用简单消息验证。使用本站 API Key 的消费记在 Lanjunex 账户，不应将 ChatGPT 订阅额度当作本站余额。
核对结果与费用
发送一次“只回复 OK”，等待完整结束，再到用量记录核对时间、模型、输入输出与费用，并在余额收支核对账本。启动成功或看到部分流式文字不等于任务完整成功。模型调用会按实际用量计费；不要仅凭回复长度估算金额。
超时或断流时先查用量和已收到的内容，再决定是否重试；不要反复发送同一个任务。核对配置和创建 Key 本身不产生模型调用费用。
退出并恢复原配置
在 Codex CLI 中运行 /quit 或正常结束会话。子 Shell 结束后，本段输入的 Key 不会留在父终端；再次运行你原来的 codex 命令，就会按原有配置启动。这段命令不执行登录/退出登录，也不覆盖 config.toml。
如果你另外通过 CC Switch 或手工保存过 Provider，需要在对应入口恢复原线路。会话记录与 CLI 自身正常写入的数据不因临时参数自动删除。停止使用本站 Key 时，到密钥页单独停用。
按具体错误排查
| 错误 | 先检查什么 |
|---|---|
| 401 / INVALID_API_KEY | 是否输入本站有效 Key，是否停用，客户端是否读到了正确鉴权来源。不要把完整 Key 放进报错截图。 |
| 404 / 模型不存在 | 复制精确 Model ID，确认 Key 授权与协议；检查是否重复添加了 /v1 或填了完整接口路径。 |
| 403 / INSUFFICIENT_BALANCE | 核对账户余额；API_KEY_EXPIRED / ACCESS_DENIED 则分别检查过期、IP 与账号权限，不能一概当作余额问题。 |
| 429 / quota / usage limit | 核对 Key 额度、周期限额与并发。有 Retry-After 时按提示等待，降低并发。 |
| 400 / 参数或协议不兼容 | 确认版本、所选协议和模型；保留脱敏 message、code 和请求标识，勿通过随意删除必填参数反复重试。 |
| 502 / 503 / 超时或断流 | 先查用量、结束原因与部分结果。稍后重试或主动选择其他获准模型，不连续重放。 |
| TLS / 连接错误 | 核对 HTTPS 地址与本机网络；不要关闭证书验证。 |
完整错误语义见错误码指南；模型拒答见拒答说明。联系客服提供时间和时区、客户端版本、模型、接口路径、脱敏错误与请求标识，不提供完整 Key。
Provider 配置未生效或参数不认识
检查所有续行反斜线后没有空格、引号成对，确认 model_provider 与 model_providers.lanjunex 名字一致。版本过旧或托管要求可能不支持当前配置；对照 codex --help 和官方配置参考处理。