---
title: Codex
description: 使用 VC 的 Responses 接口配置 Codex CLI 的服务商、模型和 API Key。
---

Codex 使用 Responses 协议。选择支持该协议和工具调用的文本模型分组，在[密钥使用说明](https://sub.vcnovb.cn/keys)中获取匹配配置。

## 安装

安装 Node.js 后，在终端运行：

```bash
npm install -g @openai/codex
codex --version
```

## 设置密钥

<CodeGroup>
```bash macOS / Linux
export VC_API_KEY="YOUR_VC_API_KEY"
```
```powershell Windows PowerShell
$env:VC_API_KEY="YOUR_VC_API_KEY"
```
</CodeGroup>

在同一终端启动 Codex，或将变量保存在操作系统的用户环境变量中，再重新启动终端。

## 配置服务商

编辑用户配置文件。macOS / Linux 为 `~/.codex/config.toml`，Windows 为 `%USERPROFILE%\.codex\config.toml`。设置过 `CODEX_HOME` 时，编辑该目录下的 `config.toml`。

将 `YOUR_MODEL_ID` 替换成当前 Key 可用的模型 ID，把以下字段合并到已有文件中。顶层的 `model_provider` 和 `model` 放在第一个方括号表头之前。

```toml
model_provider = "vc"
model = "YOUR_MODEL_ID"

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

`env_key` 填环境变量名称，密钥值放在 `VC_API_KEY` 中。此配置通过 API Key 和 HTTP 流式接口连接 VC。

## 开始使用

进入项目目录，运行 `codex`。选择信任的项目目录后，发送「读取 README 并总结项目用途，不修改文件」。可在会话中使用 `/status` 查看当前模型。

## 常见问题

- **缺少 VC_API_KEY**：在启动 Codex 的同一终端设置变量。
- **404**：`base_url` 到 `/v1` 为止，不要追加 `/responses`。
- **模型不可用**：从[模型目录](/agents/overview)复制准确 ID，核对分组的 Responses 支持。
- **修改后未生效**：检查 `CODEX_HOME`、命令行参数和所选配置档案，重新启动会话。

完整配置项见 [Codex 官方配置参考](https://developers.openai.com/codex/config-reference/)。