Source: https://aiprimetech.io/zh/docs/guides/codex-cli/

[文档](/zh/docs/) / [Codex API](/zh/codex-api/)

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

使用本指南将本地 Codex CLI 工作连接到 AI Prime Tech。您需要一个网关账户、目标 Codex 分组中的有效密钥，以及该密钥可用的模型。如果您仍在选择访问类型，请先阅读 [Codex API 概览](/zh/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。请参阅 [模型详情](/zh/openai-api/) 和 [如何比较它们](/zh/blog/gpt-6-models-for-codex/). 

## 故障排查 

  | 症状  | 检查    

  | 缺少环境变量  | 设置 AIPRIMETECH_API_KEY 在启动 Codex 的进程中。  

  | 401 身份验证错误  | 确认密钥处于有效状态、已完整复制且由此网关签发。  

  | 403 或模型不可用  | 确认密钥分组、套餐访问权限和准确的模型 ID。  

  | 404 或 HTML 响应  | 使用 https://aiprimetech.io/v1；移除重复的 /v1 或附加的 /responses.  

  | wire_api 被拒绝  | 使用 responses；旧的 chat 提供商示例已过时。  

  | 余额、套餐或速率限制错误  | 阅读错误信息，检查账户，并减少并发任务后再重试。  

  | 连接在响应过程中中断  | 尝试发送一个简短请求，检查网络或代理连接，并记录请求 ID 以便寻求支持。    

## Claude 和托管 Codex 功能 

如需通过网关的 Responses 转换使用 Claude，请按照 [在 Codex 中使用 Claude](/zh/learn/use-claude-api-with-codex/) 操作，并使用兼容的 Claude 分组密钥。上面的 GPT 示例适用于 Codex 分组访问。 

网关访问不提供 ChatGPT 工作区权益或 Codex 云端访问权限。请参阅 [登录方式比较](/zh/blog/codex-api-key-vs-chatgpt-subscription/) 了解产品边界。 

## 参考资料  
- [OpenAI：通过网关使用提供商凭据](https://learn.chatgpt.com/docs/enterprise/connect-to-a-gateway) 
- [OpenAI：配置参考](https://learn.chatgpt.com/docs/config-file/config-reference) 
- [OpenAI：高级配置和配置档案](https://learn.chatgpt.com/docs/config-file/config-advanced)