YIXO CODEX GUIDE

从安装到验证，开始使用 Codex

按顺序完成账号、密钥、环境、CCSwitch 和 Codex 配置。全程只使用壹象 AI 接口地址：https://api.yixo.com/v1。

1. 在壹象 AI 创建 API 密钥

1. 打开 api.yixo.com，注册或登录账号。
2. 进入控制台的“API 密钥”页面，点击创建密钥。
3. 选择适合当前用途的分组或模型权限，创建后立即复制并妥善保存。
4. 为不同设备或项目单独创建密钥，方便后续停用和排查。

Base URL: https://api.yixo.com/v1
API Key:  YOUR_API_KEY

2. 环境准备与 Codex 安装

Codex 命令行依赖 Node.js。请先在终端执行 node -v 与 npm -v；能看到版本号即可进入安装步骤。建议使用 Node.js 当前 LTS 版本。

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

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

3. 可选：一键导入 CCSwitch

不使用 CCSwitch 的用户可跳过本节，直接进入下一步配置 Codex。使用 CCSwitch 时，无需手动新增提供商或填写 Base URL、API Key 与模型。

1. 在 Sub2API 控制台创建 API 密钥。
2. 在该密钥所在行的“操作”栏点击“导入到 CCS”。
3. 按页面提示完成导入后，打开 CCSwitch，确认已出现壹象 AI 配置。
4. 在 CCSwitch 中选择已导入的配置并执行连接测试；成功后按 CCSwitch 的引导启动或连接 Codex。

4. 配置 Codex 使用壹象 AI

以下步骤仅适用于直连壹象 AI 的用户。关闭正在运行的 Codex 后，创建或编辑用户目录中的配置文件；将 YOUR_MODEL_ID 改为控制台显示的可用模型，YOUR_API_KEY 改为你自己的密钥。

直连壹象 AI：config.toml

model_provider = "yixo"
model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

[model_providers.yixo]
name = "Yixo AI"
base_url = "https://api.yixo.com/v1"
wire_api = "responses"
requires_openai_auth = false

直连壹象 AI：auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

5. 验证配置

先用与 Codex 相同的 Responses 接口确认密钥、网络和模型可用，再启动 Codex。以下命令仅用于直连壹象 AI；使用 CCSwitch 时，请按“导入到 CCS”完成后的 CCSwitch 连接方式进行测试。

Windows PowerShell

curl.exe "https://api.yixo.com/v1/responses" `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer YOUR_API_KEY" `
  -d '{"model":"YOUR_MODEL_ID","input":"你好，请返回一条测试消息"}'

macOS 终端

curl https://api.yixo.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"YOUR_MODEL_ID","input":"你好，请返回一条测试消息"}'

1. 返回正常 JSON：说明密钥、网络和 Base URL 已连通。
2. 随后在项目目录执行 codex。
3. 输入一个简单请求，例如“说明当前目录中的文件”，确认 Codex 能正常响应。

常见问题