Claude Code | Vtrix API Docs

概述

Claude Code 是 Anthropic 官方的命令行 AI 编程助手. 将其网关配置为 Vtrix 后, 可通过统一入口使用 Claude, GPT, Gemini 等多种模型.

环境要求

Node.js 18 及以上
Vtrix API Key, 在设置中创建

配置步骤

安装 Claude Code

使用 npm

npm install -g @anthropic-ai/claude-code

或使用安装脚本（macOS / Linux）

curl -fsSL https://claude.ai/install.sh | sh

配置 Vtrix API

Vtrix 支持全局配置文件或环境变量, 推荐使用配置文件.

使用配置文件（推荐）

创建 ~/.claude/settings.json：

mkdir -p ~/.claude

配置文件内容：~/.claude/settings.json

vim ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cloud.vtrix.ai/llm",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_VTRIX_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5"
  }
}

提示： 在 Vtrix 网站打开模型页面, 选择模型（例如 Claude Sonnet 4.5）, 点击 API 标签, 可复制相关的配置项.

使用环境变量

在 ~/.bashrc 或 ~/.zshrc 中加入：

# Vtrix API 配置
export ANTHROPIC_BASE_URL="https://cloud.vtrix.ai/llm"
export ANTHROPIC_AUTH_TOKEN="YOUR_VTRIX_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

注意： 修改后请重启终端, 或执行 source ~/.zshrc（或你实际使用的配置文件）. Windows 用户请重新打开命令提示符.

切换模型

随时修改 ANTHROPIC_MODEL 即可切换模型.

类型	推荐模型	说明
高性能	`claude-opus-4-5`	推理能力强, 适合复杂任务
标准	`claude-sonnet-4-5`	日常开发, 均衡
高性价比	`gemini-3-pro-preview`	响应快, 成本较低

切换后的 settings.json 示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cloud.vtrix.ai/llm",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_VTRIX_API_KEY",
    "ANTHROPIC_MODEL": "gemini-3-pro-preview" // Change this
  }
}

提示： 在模型页面查看全部模型, 能力与价格. 请优先选择支持 Tool Calling（工具调用） 的模型.

启动会话

导航到你的项目目录并启动 Claude Code：

cd /path/to/your/project
claude

配置生效后, 你发送的任何提示都将通过 Vtrix 路由.

校验配置

在 Claude Code 中运行 /status 命令以验证你的连接：

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Base URL: https://cloud.vtrix.ai/llm
Model: claude-sonnet-4-5

也可在 Vtrix 账户的设置中查看账单以确认请求是否到达.

故障排查

报错：API Error: Connection error

原因： 单次任务过大, 执行超时.

处理： 让 Claude Code 把任务拆成小步骤, 例如：

请把任务拆成多步, 每次只做一小处修改

Mac：env: node: No such file or directory

原因： 当前终端会话未正确加载 Node.js（常见于 nvm）.

处理：

\. "$HOME/.nvm/nvm.sh"
claude

报错：API Error: 400 tools.3.custom.input_examples: Extra inputs are not permitted

原因： Claude Code 已知问题, 后续版本可能修复.

临时处理：

rm ~/.claude/statsig/statsig.cached.evaluations

然后 完全退出并重新打开 Claude Code, 不要在同一会话里继续操作.

其他配置问题

确认 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL 已正确设置
确认 API Key 可用
所选模型需支持 tool calling
确认账户额度：查看余额

如需更多帮助, 可查阅本站其余文档或联系 Vtrix 支持.