Claude Code 部署

本文介绍如何安装 Claude Code 并接入 KvioAI 中转站。

前置条件： 系统已安装 Node.js 18+ 和 npm。如未安装，请参考 Node.js 安装指南。

第一步：安装 Claude Code

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

安装完成后，运行 claude --version 确认安装成功。

第二步：配置 API Key 和 Base URL

从 KvioAI 控制台获取的 Key 是 JSON 数组格式：

[{"_type":"newapi_channel_conn","key":"sk-xxxxx...xxxxx","url":"https://kvioai.cloud"}]

你需要从中提取：

• key 字段的值（即 sk-xxxxx...xxxxx）→ 用于 ANTHROPIC_API_KEY
• url 字段加上 /v1（即 https://kvioai.cloud/v1）→ 用于 ANTHROPIC_BASE_URL

方式一：环境变量（推荐）

编辑你的 shell 配置文件：

nano ~/.bashrc   # 或 ~/.zshrc

在文件末尾添加：

export ANTHROPIC_API_KEY="你的key值"
export ANTHROPIC_BASE_URL="https://kvioai.cloud/v1"

保存后执行 source ~/.bashrc（或 source ~/.zshrc）使其生效。

方式二：项目级 .env 文件

在项目根目录创建 .env 文件：

cd ~/your-project
cat > .env << EOF
ANTHROPIC_API_KEY=你的key值
ANTHROPIC_BASE_URL=https://kvioai.cloud/v1
EOF

Claude Code 在该目录下启动时会自动读取 .env 文件。

方式三：settings.json

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "你的key值",
    "ANTHROPIC_BASE_URL": "https://kvioai.cloud/v1"
  }
}

第三步：启动 Claude Code

claude

Claude Code 会自动读取环境变量中的配置，通过 KvioAI 中转站连接 AI 模型。

验证连接

配置完成后，可以用以下命令快速验证 API 是否通畅：

curl -s -X POST "https://kvioai.cloud/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":100,"messages":[{"role":"user","content":"Hi"}]}'

返回有效 JSON 响应即表示连接正常。

指定默认模型

可以通过环境变量指定 Claude Code 默认使用的模型：

export ANTHROPIC_MODEL=claude-sonnet-4-20250514

常见问题

提示认证失败 / 401 错误？

• 确认 Key 值正确，只复制 key 字段的值，不要带入 JSON 的引号或多余字符
• 确认环境变量已生效（运行 echo $ANTHROPIC_API_KEY 检查）

连接超时？

• 确认 ANTHROPIC_BASE_URL 包含了 /v1 后缀
• 检查网络是否正常

📱 获取帮助 使用过程中如有问题，请添加微信 vp4wt 获取技术支持。