跳到正文
VC API控制台
‹ 返回接入手册

Codex CLI 接入

Codex 如何配置 VC API

Codex 可通过自定义模型提供方连接 Responses 接口。先从 VC API 的密钥“使用”弹窗获取对应分组配置，再核对模型、Base URL 和认证方式。

VC API 编辑整理 / 更新于

准备客户端和密钥

  1. 按 Codex CLI 文档安装客户端，运行 codex --version记录当前版本。
  2. 在 模型广场确认分组支持 Codex / Responses 及目标模型。
  3. 打开 API 密钥页面，点击“使用”，选择 Codex 与当前系统。优先采用弹窗提供的配置和模型目录。

下面是 API Key 方式的基础示例，不覆盖所有分组和扩展能力。完整配置以控制台生成结果为准；修改前备份已有文件。

设置密钥环境变量

macOS / Linux

export VC_API_KEY="替换为你的 API Key"

Windows PowerShell

$env:VC_API_KEY="替换为你的 API Key"

环境变量需要在启动 Codex 的终端中设置。env_key 填变量名，不填密钥内容。

配置模型提供方

合并以下配置到 ~/.codex/config.toml（Windows 用户目录下的 .codex/config.toml）。不要重复添加同名 TOML 表，也不要直接覆盖已有工具配置。

model_provider = "vc_api"
model = "替换为分组支持的模型 ID"

[model_providers.vc_api]
name = "VC API"
base_url = "https://sub.vcnovb.cn/v1"
env_key = "VC_API_KEY"
wire_api = "responses"
requires_openai_auth = false

示例已使用散户站域名；请将模型 ID 替换为分组支持的值，并核对控制台给出的实际路径。base_url 通常以 /v1 结尾，不要写成完整的 /v1/responses 请求路径。若控制台提供专用前缀或其他认证配置，请按其指引操作。

验证调用与排错

  1. 在同一个终端运行 codex，确认当前模型和提供方。
  2. 发送一条简短测试消息，再到控制台核对用量记录。测试调用可能计费。
  3. 若提示环境变量缺失，检查变量名和启动终端；401 检查密钥；404 检查路径、模型 ID 和 Responses 支持情况。
  4. 如果仍要求旧的登录方式，检查所选 profile、提供方名称，以及是否还有覆盖当前设置的配置。

工具调用、图片、长上下文和推理参数的可用性由模型与分组决定，基础文本配置不等于所有功能均受支持。

参考与下一步

本教程依据 VC API 当前配置界面编写，未宣称通过所有客户端版本的实测。客户端升级后，请优先核对控制台生成配置与客户端文档。

打开 API 密钥页面了解费用