Claude Code 快速配置

本文介绍如何将 KvioAI 的 API Key 配置到 Claude Code 中。整个过程只需三步：获取 Key、设置环境变量、启动 Claude Code。

💡 提示 Claude Code 原生支持通过环境变量指定 API 地址和密钥，无需任何额外工具或脚本。

配置方法

方式一：通过环境变量配置（推荐）

编辑你的 shell 配置文件：

nano ~/.bashrc   # 或 ~/.zshrc（取决于你用的 shell）

在文件末尾添加以下两行：

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

保存后执行 source 使其生效：

source ~/.bashrc   # 或 source ~/.zshrc

验证配置是否生效：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

方式二：通过 settings.json 配置

Claude Code 也支持在 ~/.claude/settings.json 中配置：

nano ~/.claude/settings.json

添加以下内容（如果文件已存在其他配置，只需将 env 块合并进去即可）：

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

使用方法

步骤 1：获取 Key

登录 kvioai.cloud，进入控制台创建你的专属 API Key。创建后你会得到类似这样的内容：

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

这是一个 JSON 数组，你需要从中提取两个值：

• key → 即 ANTHROPIC_API_KEY 的值（上面的 sk-xxxxx...xxxxx）
• url → Base URL 的地址，需要加上 /v1 后缀作为 ANTHROPIC_BASE_URL（即 https://kvioai.cloud/v1）

不想手动提取？ 如果你的 shell 支持 jq，可以一行命令提取：

# 假设你的完整 Key 字符串保存在变量中
echo '[{"_type":"newapi_channel_conn","key":"sk-xxx","url":"https://kvioai.cloud"}]' | jq -r '.[0].key'

步骤 2：配置环境变量

按上述「方式一」或「方式二」，将提取出的 key 和 url/v1 填入对应配置项。

步骤 3：启动 Claude Code

配置完成后，直接运行：

claude

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

常见问题

配置后 Claude Code 无法连接？

• 确认 Key 是否正确，从 JSON 中只复制 key 字段的值，不要带入多余的引号或空格
• 确认 ANTHROPIC_BASE_URL 包含 /v1 后缀
• 运行 echo $ANTHROPIC_BASE_URL && echo $ANTHROPIC_API_KEY 检查环境变量是否已生效

如何在多台电脑上使用？

同一个 Key 可以在多台设备上使用，在每台电脑上按上述步骤配置一次即可。

需要 Node.js 环境吗？

Claude Code 本身需要 Node.js 环境，请确保已正确安装。

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