Codex CLI 配置 CodePass 凭证教程
Codex CLI 支持自定义 SDK 凭证接入第三方额度源,本文说明配置流程、验证方式和常见问题排查思路。

Codex CLI 的凭证机制
Codex CLI 和大多数命令行 AI 工具一样,支持通过配置文件或环境变量指定接口地址和认证密钥,这套机制官方本来就是开放的,用来支持企业自建网关或第三方额度服务。CodePass 为 Codex CLI 生成的是 SDK 凭证,配置方式和填一个标准 API Key 差别不大[1]。
配置步骤
先在 CodePass 后台确认 Codex 对应的凭证已生成,把接口地址和密钥按提示填入 Codex CLI 的配置文件或对应的环境变量,保存后重新启动一次 CLI 会话让新配置生效。具体的配置文件位置和字段名称,以 Codex CLI 当前版本的官方说明和 CodePass 后台给出的示例为准。
验证接入是否成功
配置完成后执行一次正常的命令行任务,比如让它读一个文件并做简单修改,如果能正常返回结果,同时在 CodePass 后台看到 Codex 这部分用量增加,就说明接入成功了。
常见问题排查
认证失败通常是密钥复制不完整或者多了空格换行。接口超时或不可达,优先排查网络连通性。如果命令能执行但内容明显不对,检查一下是不是配置文件里还残留着旧的官方直连凭证,两套配置同时存在时可能会互相冲突。
常见问题
Codex CLI 换成 CodePass 凭证后,命令用法会变吗?
不会,命令行的用法、参数完全不变,改变的只是请求实际发往哪个接口。
一份 CodePass 凭证能不能同时给多台电脑用?
可以,凭证本身不绑定设备,但要注意如果多台设备同时高频调用,消耗余额的速度也会相应变快。
配置完成后官方账号还需要保留吗?
看个人需求,Codex CLI 走 CodePass 凭证接入不依赖官方付费订阅,但如果你还想用官方的免费额度或其他功能,账号本身可以继续保留。