验道

指南

Claude CLI 配置指南

安装并配置 Claude Code / CLI，指向自定义 Base URL 与 API Key，完成可用性校验。

配置向导

不落盘 Key

填写后生成可复制配置，并可调用本站检测接口做一次校验。API Key 仅保留在当前页面内存中。

配置片段

# Claude Code / CLI
export ANTHROPIC_BASE_URL="https://your-gateway.example.com"
export ANTHROPIC_API_KEY="sk-ant-your-key"

# 可选：指定默认模型
# export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

# 验证（示例）
# claude --version

前置条件

  • 已安装 Node.js 20+（推荐 22 LTS）
  • 具备可用的 Base URL 与 API Key（Anthropic 兼容接口）
  • 建议先在本站 检测页 确认渠道可用，再写入本地配置

安装 Claude Code / CLI

以官方 Claude Code 为例（命令随版本可能略有差异，以当前文档为准）：

# 确认 Node 版本
node -v

# 按官方方式安装 Claude Code / CLI
npm install -g @anthropic-ai/claude-code

安装完成后，在终端确认可执行：

claude --version

若使用其他兼容客户端，安装方式以其文档为准；下方向导可生成通用环境变量片段。

配置自定义 Base URL 与 Key

核心思路：让客户端请求打到你的兼容网关，而不是默认官方端点。

常用环境变量：

export ANTHROPIC_BASE_URL="https://your-gateway.example.com"
export ANTHROPIC_API_KEY="sk-ant-..."

注意：

  1. Base URL 一般指向网关根地址（是否带 /v1 取决于网关约定，以服务商说明为准）
  2. API Key 不要提交到 Git，不要写进公开 README
  3. 本站配置向导不会持久化 Key，仅在浏览器内存中生成片段

完成配置后，用本页向导的「校验配置」按钮，或前往 检测页 做一次真实探测。

常见错误码对照

现象 / 状态码可能原因处理建议
401 UnauthorizedKey 错误、过期、未带鉴权头核对 Key 前后空格；确认使用 x-api-key / Authorization 约定与网关一致
403 Forbidden无权限、IP/地区限制、模型未开通向服务商确认账号权限与可用模型清单
429 Too Many Requests触发速率限制或并发上限降低并发；等待窗口重置；确认套餐配额
Timeout / 网络超时上游慢、代理链路不稳、防火墙拦截换网络重试；检查 Base URL 是否可达；延长客户端超时
Model not found模型名拼写错误或渠道未提供该模型对照服务商模型列表；改用已知可用模型后再测

校验清单

  1. Base URL 可解析且 HTTPS 正常
  2. Key 能通过鉴权（非 401/403）
  3. 目标模型可完成一次简单补全
  4. （可选）流式响应可用

全部通过后再把配置固化到 shell profile 或客户端设置中。