Cubicspaces API

简体中文

English

简体中文

English

Appearance

使用 Codex CLI ​

本文介绍如何通过 Cubicspaces 在 Codex CLI 中使用可用模型。

准备工作 ​

  • 已安装 Codex CLI。
  • 已创建 Cubicspaces API Key。
  • 已确认账户可使用的模型名称。模型名称以 Cubicspaces 控制台中提供的名称为准。

配置 API Key ​

将 API Key 作为环境变量提供给 Codex CLI。请在启动 Codex 的同一个终端中设置变量：

powershell
$env:CODEX_GATEWAY_API_KEY = "YOUR_API_KEY"
codex
bash
export CODEX_GATEWAY_API_KEY="YOUR_API_KEY"
codex

请将 YOUR_API_KEY 替换为自己的密钥。不要把密钥提交到代码仓库或发送给他人。若使用密钥管理工具，也可以通过它向 Codex CLI 进程注入此环境变量。

在 Windows 桌面版中使用 ​

如果从开始菜单启动 Codex 桌面版，另一个 PowerShell 窗口中临时设置的变量不会自动传给桌面版。请将 CODEX_GATEWAY_API_KEY 设置为 Windows 用户环境变量：

  1. 按 Win + R，输入 sysdm.cpl 并回车。
  2. 打开“高级”→“环境变量”。
  3. 在上半部分的“用户变量”中点“新建”。
  4. 变量名填写 CODEX_GATEWAY_API_KEY，变量值填写自己的 Cubicspaces API Key，然后保存。
  5. 完全退出 Codex 桌面版，再重新打开。

桌面版与 CLI 使用同一份 Codex 配置文件；Windows 默认路径为 %USERPROFILE%\.codex\config.toml。不要把 API Key 写进 TOML 配置文件。

配置 Codex CLI ​

配置文件路径：

  • Windows：%USERPROFILE%\.codex\config.toml
  • macOS、Linux 和 WSL：~/.codex/config.toml

添加或合并以下配置。此处以 gpt-6-astra 为例；请确认你的 Codex 版本识别此模型，并且 Cubicspaces 账户可使用这个准确的模型名称。如果网关使用 Codex 不识别的自定义别名，请向管理员索取匹配的模型目录配置。

toml
model = "gpt-6-astra"
review_model = "gpt-6-astra"
model_reasoning_effort = "high"
model_provider = "cubicspaces"

[model_providers.cubicspaces]
name = "Cubicspaces"
base_url = "https://cubicspaces.cloud/v1"
wire_api = "responses"
env_key = "CODEX_GATEWAY_API_KEY"

model、review_model、model_reasoning_effort 和 model_provider 是顶层设置。如果文件已有 [desktop] 等表段，请把这四行放在文件开头、首个表段之前；不要放到 [desktop] 下面。[model_providers.cubicspaces] 是独立表段，不要嵌套在 [desktop] 下。不要重复添加已存在的键或表段。

如果你的账户或管理员提供了专用 API 地址，请使用该地址替换示例中的 base_url。不要在配置文件中写入 API Key。

验证连接 ​

启动 Codex CLI 后，先运行 /status，确认当前模型和提供方配置符合预期。然后发送一个简单提示，例如：

text
Reply with exactly: gateway-ok

收到回复表示基本请求已连通。之后建议继续验证流式输出、多轮对话，以及工具调用后继续对话的场景。仅收到一条文本回复，不能证明流式和工具往返都兼容；完整兼容性取决于 Codex CLI、所选模型及网关对 Responses API 事件和历史项的支持。

常见问题 ​

401 或认证失败 ​

确认环境变量名称为 CODEX_GATEWAY_API_KEY，值是有效的 Cubicspaces API Key，并且启动 Codex CLI 的终端已设置该变量。

404 或找不到请求路径 ​

检查 base_url 是否正确。默认地址为 https://cubicspaces.cloud/v1，末尾的 /v1 不能省略。

模型不可用 ​

将 model 和 review_model 改为账户可用的准确模型名称。Codex CLI 与网关都需要支持所选模型。

更多关于 Codex 自定义模型提供方的说明，请参阅 Codex 官方网关兼容性文档。

Copyright © 2026-present Cubicspaces