核心编程工具

Claude Code

本文介绍通过 KeyVia 配置 Claude Code 的接入方式,包括准备 API 密钥、配置接口地址及验证连接。

1安装

需要 Node.js 18 或更高版本。已安装 Claude Code 的可跳过。

终端
npm install -g @anthropic-ai/claude-code
claude --version

2配置接入

示例中的 YOUR_API_KEY 是占位符,直接复制无法使用。登录后可选择自己的密钥,自动填入本页全部示例。

登录后填入密钥

把地址和密钥写进 Claude Code 自己的配置文件,永久生效且不污染系统环境变量。把 YOUR_API_KEY 换成你的密钥,或在页面顶部选择密钥自动填入。

手动方式:把以下内容合并到 ~/.claude/settings.json(保留文件里原有的其他设置)
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.keyvia.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}
或复制这段到终端执行:自动合并并备份原文件为 settings.json.bak,不下载任何东西
node - <<'EOF'
const fs = require("fs"), path = require("path")
const file = path.join(require("os").homedir(), ".claude", "settings.json")
fs.mkdirSync(path.dirname(file), { recursive: true })
let config = {}
if (fs.existsSync(file)) {
  fs.copyFileSync(file, file + ".bak")  // 先备份原文件
  try { config = JSON.parse(fs.readFileSync(file, "utf8") || "{}") }
  catch { console.error("现有 settings.json 格式有误,未做任何修改"); process.exit(1) }
}
config.env = { ...config.env,  // 只改下面这几项,其他设置原样保留
  ANTHROPIC_BASE_URL: "https://api.keyvia.cc",
  ANTHROPIC_AUTH_TOKEN: "YOUR_API_KEY",
}
fs.writeFileSync(file, JSON.stringify(config, null, 2) + "\n")
console.log("已安全合并至 " + file + " (已备份原文件为 settings.json.bak)")
console.log("配置完成,请进入你的项目目录,输入 claude 即可使用。")
EOF

为什么写 settings.json 而不是系统环境变量

只对 Claude Code 生效,不影响机器上其他使用 Anthropic SDK 的项目;每次打开新终端自动加载,不用再 source。

3验证

进入项目目录运行 claude,在交互界面输入 /status,确认显示的 Base URL 是 https://api.keyvia.cc。Claude Code 能读取项目并回复,即接入成功。

  • 已经打开的会话不会重新读取配置,改完配置请完全退出再启动。
  • 报 401 / 403 / 429 见 错误码。
  • 提示模型不可用:先到 模型广场 确认模型名,再检查 Key 绑定的分组是否支持 Anthropic 协议。
KeyVia Logo
KeyVia

一个API接口以超低价接入满血Claude、GPT、Gemini等主流AI大模型。

© 2026 KeyVia. All rights reserved.