Codex CLI：API 密钥与自定义提供方设置

使用本指南将本地 Codex CLI 工作连接到 AI Prime Tech。您需要一个网关账户、目标 Codex 分组中的有效密钥，以及该密钥可用的模型。如果您仍在选择访问类型，请先阅读 Codex API 概览 ，以便选择访问类型。

1. 检查密钥与分组

在控制面板中创建密钥。预付费 GPT 访问使用 Codex 组。如果提供限时 Codex 访问，请以该套餐显示的组和条款为准；Claude 访问是独立的。请确认你将使用的密钥所支持的模型列表。

在当前终端中设置密钥。在本地替换占位符；不要将密钥提交到代码仓库。

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash 或 zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

如果在设置环境变量之前启动的终端或编辑器无法读取该变量，请重新启动它。这些示例为当前进程及其子进程设置该变量。

2. 配置提供方

将以下内容合并到您的用户级 ~/.codex/config.toml中。在 Windows 上，对应路径为 %USERPROFILE%\.codex\config.toml。提供方凭据应放在用户配置中，而不是代码仓库的 .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

使用提供方 ID，例如 aiprimetech ，并确保 model_provider 与其对应的配置表匹配。当前 Codex 使用 Responses 协议。基础 URL 是网关的 /v1 根地址；Codex 会添加请求路径。此配置使用 HTTP/SSE 传输。

3. 验证连接

运行 codex doctor 以检查您的 CLI 配置。启动 codex，然后使用 /status 确认提供方和模型。在允许执行较大规模的代码仓库任务之前，先让它给出简短回答。检查该请求是否出现在您的 AI Prime Tech 用量页面中。

您可以独立于 Codex 检查密钥的模型列表：

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

如果返回的目录包含您的模型，但请求失败，请检查实际错误和当前分组的可用性。仅列出某个 ID 并不代表推理测试成功。

保留可选的 CLI 配置文件

若只想在特定 CLI 会话中选择此提供方，请将上述配置放入 ~/.codex/aiprimetech.config.toml ，然后启动：

codex --profile aiprimetech

在 Codex 0.134.0 及更高版本中，CLI 配置使用独立文件。旧版 [profiles.aiprimetech] 示例不是当前的配置文件格式。IDE 扩展使用用户级配置；重启后请验证其当前使用的提供方，不要假定 CLI 配置切换也已在扩展中生效。

选择模型

使用 gpt-6.1-sol 作为编码工作的起点，使用 gpt-6-astra 处理高要求任务，或使用 gpt-6-luna 处理专项工作。 gpt-6-sol 是现有 Sol 工作流使用的独立 ID。请参阅 模型详情 和 如何比较它们.

故障排查

Claude 和托管 Codex 功能

如需通过网关的 Responses 转换使用 Claude，请按照 在 Codex 中使用 Claude 操作，并使用兼容的 Claude 分组密钥。上面的 GPT 示例适用于 Codex 分组访问。

网关访问不提供 ChatGPT 工作区权益或 Codex 云端访问权限。请参阅 登录方式比较 了解产品边界。

参考资料

• OpenAI：通过网关使用提供商凭据
• OpenAI：配置参考
• OpenAI：高级配置和配置档案