AI Vetcc
AI Gateway Setup / 编程工具统一接入

API 中转站接入教程

按 Codex IDE、TREA/Trae IDE、Codex CLI、Claude Code 的顺序,把常用编程工具接到同一个中转网关。页面统一使用 OpenAI provider,网关根地址为 https://ai.vexcc.cc。

OpenClaw 自定义大模型接入

面向已经有自定义模型 / 中转 API 的用户:从 curl 测试、OpenAI / Anthropic 协议配置、Provider 写法,到验证和排障,整理成一页可复制教程。

OpenAI 兼容接口快速接入

适合 AI Vetcc 中转、OpenAI Chat Completions 与 Anthropic Messages 两类自定义模型网关。

  1. 1先用 curl 测通 /v1/models 或 /v1/chat/completions。
  2. 2设置 OPENAI_BASE_URL / ANTHROPIC_BASE_URL、API Key 和 agents.defaults.model.primary。
  3. 3用 openclaw models status --probe 做真实验证。

Hermes Agent 自定义大模型接入

面向 Hermes CLI、微信/Telegram Gateway、API Server 等入口:同时覆盖 OpenAI Chat Completions 与 Anthropic Messages 两种协议配置。

Hermes 配置文件 + .env 接入

配置路径、API Key、Base URL、模型名、Gateway 重启和真实对话验证都整理在一页。

  1. 1用 hermes config path 和 hermes config env-path 确认配置位置。
  2. 2OpenAI 使用 gpt-5.6-terra,Anthropic 使用 Claude 模型列表。
  3. 3CLI 重新打开生效;Gateway 入口执行 hermes gateway restart。

VS Code 使用 Claude Code

在 VS Code 集成终端里运行 Claude Code,并接入 AI Vetcc 的 Anthropic 兼容网关,适合直接读项目、改代码和跑测试。

VS Code Terminal + Claude CLI

包含安装、环境变量、模型选择、交互模式、print 模式和常见报错处理。

  1. 1安装 @anthropic-ai/claude-code 并确认 claude doctor 正常。
  2. 2配置 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL 和 Claude 模型。
  3. 3在 VS Code 项目根目录打开终端,运行 claude 开始使用。

AI Vetcc 平台操作手册

给新用户的入口卡片:兑换额度、创建 API Key、查看模型渠道、导入 CCSwitch,一页走完。

新用户从兑换到调用的完整流程

适合刚拿到兑换码或 API Key 的用户,按步骤完成平台配置。

平台操作手册

重点覆盖:额度兑换、API 密钥创建、可用渠道 / 支持模型查看、渠道状态判断、OpenAI / Anthropic Base URL,以及 CCSwitch / CCS 导入。

兑换额度API Key模型渠道CCSwitch故障排查
  1. 01兑换码开通额度 / 并发 / 模型权限
  2. 02按 GPT、Claude 分组创建独立 API Key
  3. 03确认可用渠道、支持模型和线路状态
  4. 04复制密钥或一键导入 CCSwitch / CCS

Codex IDE 接入

Codex IDE 读取本机 Codex 配置。先创建 config.toml 和 auth.json,再重启 IDE,让扩展按本机配置连接 AI Vetcc。

Windows 完整流程

适合 VS Code / Cursor 等安装 Codex IDE 扩展的环境。

  1. 1安装并打开 Codex IDE 扩展。
  2. 2创建配置目录。
PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
  1. 3创建配置文件。路径为 %USERPROFILE%\.codex\config.toml。
%USERPROFILE%\.codex\config.toml
model_provider = "OpenAI"
model = "gpt-5.6-terra"
review_model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ai.vexcc.cc"
wire_api = "responses"
requires_openai_auth = true
  1. 4创建认证文件。路径为 %USERPROFILE%\.codex\auth.json。
%USERPROFILE%\.codex\auth.json
{
  "OPENAI_API_KEY": "这里换成你申请的 KEY"
}
  1. 5完全退出并重新打开 IDE,然后打开 Codex 面板开始使用。

macOS 完整流程

配置内容与 Windows 一致,只是文件路径不同。

  1. 1安装并打开 Codex IDE 扩展。
  2. 2创建配置目录并编辑配置文件。
Terminal
mkdir -p ~/.codex
nano ~/.codex/config.toml
~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.6-terra"
review_model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ai.vexcc.cc"
wire_api = "responses"
requires_openai_auth = true
  1. 3创建认证文件。路径为 ~/.codex/auth.json。
~/.codex/auth.json
{
  "OPENAI_API_KEY": "这里换成你申请的 KEY"
}
  1. 4完全退出并重新打开 IDE,然后打开 Codex 面板开始使用。

IDE 内测试

先用最小请求确认 Codex IDE 已走中转网关。

  1. 1打开项目文件夹,不要只打开单个文件。
  2. 2打开 Codex 面板,确认模型显示为 gpt-5.6-terra。
  3. 3发送一句测试消息:用一句话回复 AI Vetcc 已连接。
  4. 4如果能正常回复,就可以开始让 Codex 读取、修改和解释项目代码。

IDE 常见问题

配置正确但 IDE 不生效时,优先检查这几项。

  1. 1确认 config.toml 和 auth.json 文件名没有多出 .txt 后缀。
  2. 2确认 auth.json 是合法 JSON,Key 前后不要漏双引号。
  3. 3重启 IDE 后仍不生效,就先在终端运行 codex 测试同一套配置。
  4. 4如果终端可用但 IDE 不可用,更新 Codex IDE 扩展或检查扩展是否支持读取本机 Codex 配置。

TREA/Trae IDE 配置

按顺序添加自定义 OpenAI 模型。TREA/Trae 的 URL 使用完整 Chat Completions 接口:https://ai.vexcc.cc/v1/chat/completions。

添加自定义模型

入口路径为:设置 -> 模型 -> 添加自定义模型。

  1. 1打开 TREA/Trae IDE,进入 设置 -> 模型 -> 添加自定义模型。
  2. 2Provider 选择 OpenAI。
  3. 3按下面字段填写并保存。
NameAI Vetcc
ProviderOpenAI
URLhttps://ai.vexcc.cc/v1/chat/completions
API Key这里换成你申请的 KEY
Model IDgpt-5.6-terra
如果界面里字段名叫 Endpoint、API URL、Request URL 或 Chat Completion URL,也填写同一个完整地址。

选择与测试

保存后先用文本对话测试,不要先测图片或工具调用。

  1. 1回到 TREA/Trae 的 AI 聊天或代码助手面板。
  2. 2在模型列表中选择刚创建的 AI Vetcc / gpt-5.6-terra。
  3. 3发送测试消息:用一句话回复 AI Vetcc 已连接。
  4. 4如果正常回复,就可以开始让 TREA/Trae 解释代码、生成代码或修改项目。

排查顺序

遇到报错时按状态码和字段逐项排查。

  1. 1确认 URL 是完整的 https://ai.vexcc.cc/v1/chat/completions。
  2. 2确认 API Key 已替换为你申请的 KEY,不要带多余空格。
  3. 3404 通常是 URL 填错;401 通常是 Key 错误;模型不存在时改用中转站后台返回的模型 ID。
  4. 4如果当前版本没有自定义 URL 或 Endpoint 输入框,需要更新版本或换支持自定义网关的客户端。

Codex CLI 配置

适合终端使用。Provider 统一选择 OpenAI,并把 base_url 指向 AI Vetcc 网关。

Windows

推荐使用 PowerShell 创建配置文件。

  1. 1安装 Node.js 18 或更新版本,已经安装可跳过。
  2. 2安装 Codex CLI。
PowerShell
npm i -g @openai/codex
codex --version
  1. 3创建配置目录。
PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
  1. 4创建配置文件。路径为 %USERPROFILE%\.codex\config.toml。
%USERPROFILE%\.codex\config.toml
model_provider = "OpenAI"
model = "gpt-5.6-terra"
review_model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ai.vexcc.cc"
wire_api = "responses"
requires_openai_auth = true
  1. 5创建认证文件,路径为 %USERPROFILE%\.codex\auth.json。
%USERPROFILE%\.codex\auth.json
{
  "OPENAI_API_KEY": "这里换成你申请的 KEY"
}

macOS

推荐用 Homebrew 安装 Node.js。

  1. 1安装 Node.js 与 Codex CLI。
Terminal
brew install node
npm i -g @openai/codex
codex --version
  1. 2创建配置文件。
Terminal
mkdir -p ~/.codex
nano ~/.codex/config.toml
~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.6-terra"
review_model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ai.vexcc.cc"
wire_api = "responses"
requires_openai_auth = true
  1. 3创建认证文件,路径为 ~/.codex/auth.json。
~/.codex/auth.json
{
  "OPENAI_API_KEY": "这里换成你申请的 KEY"
}
  1. 4进入项目目录并启动 Codex。
Terminal
nano ~/.codex/auth.json
cd your-project-folder
codex
Codex 当前配置使用 Responses API。若服务端不支持 /v1/responses,需要在中转站后台开启 Responses 兼容路由或更换支持该协议的模型。

Claude Code 配置

Claude Code 走 Anthropic 兼容环境变量。是否需要带 /v1 取决于中转站的 Anthropic 路由实现。

Claude Desktop(CSS配置版本) / CSS setup

使用 CC Switch/CSS 接入 AI Vetcc,含创建密钥、添加供应商、开启路由和截图说明。
Use CC Switch/CSS to connect Claude Desktop to AI Vetcc, with key creation, provider setup, routing and screenshots.

  1. 1先下载并打开 CC Switch。
  2. 2后台创建密钥并导入 CSS。
  3. 3选择 Claude Desktop、获取模型列表并开启路由。

Claude Desktop(dev模式配置版本) / Developer mode setup

通过 Claude Desktop Developer Mode 直接填写 Gateway、Static API key、Base URL 和模型发现,不依赖 CSS。
Configure Gateway, Static API key, Base URL and model discovery directly in Claude Desktop Developer Mode, without CSS.

  1. 1Help -> Troubleshooting -> Enable Developer Mode,并重启客户端。
  2. 2Developer -> Configure Third-Party Inference。
  3. 3Connection 选 Gateway,Credential kind 选 Static API key。
  4. 4Base URL 填 https://ai.vexcc.cc/v1,Auth scheme 选 bearer。
查看 dev 模式图文教程 / Open dev mode guide

Windows

使用用户级环境变量,重开终端生效。

PowerShell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.vexcc.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的中转站密钥", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "sonnet", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "1", "User")
启动
cd your-project-folder
claude

macOS / Linux

写入当前 shell,确认可用后再放进 shell profile。

Terminal
export ANTHROPIC_BASE_URL="https://ai.vexcc.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的中转站密钥"
export ANTHROPIC_MODEL="sonnet"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

cd your-project-folder
claude
如果中转站要求 Anthropic 路由带路径,请把 ANTHROPIC_BASE_URL 改成后台给出的完整 Anthropic Base URL。TREA/Trae 的 /v1/chat/completions 不一定等于 Claude Code 的 Anthropic Base URL。

排查提示

遇到连接失败时,优先检查这几个点,通常能很快定位问题。

配置检查

最常见的问题都在路径、Key 和模型名。

  1. 1Key 是否正确。 必须替换成自己的中转站 Key。
  2. 2URL 是否正确。 Codex 和 Claude Code 使用 https://ai.vexcc.cc;TREA/Trae 使用 https://ai.vexcc.cc/v1/chat/completions。
  3. 3模型是否存在。 以后台模型列表或 /v1/models 返回值为准。
  4. 4协议是否匹配。 Codex 配置使用 responses,中转站需要支持 /v1/responses。

常见报错

按状态码判断下一步。

  1. 401Key 错误、Key 未启用,或客户端没有带 Bearer 鉴权。
  2. 404URL 路径不对,按对应客户端重新核对 Codex、TREA/Trae 或 Claude Code 的地址。
  3. 429额度、频率或并发限制触发,稍后重试或调整套餐。
  4. 500上游模型或中转服务异常,换模型或查看中转站后台日志。
已复制