Zivv Docs

主题

Claude Code 配置指南 ​

Claude Code 是 Anthropic 官方的编程助手。Zivv 提供 Anthropic Messages API 兼容网关，可通过官方支持的网关环境变量接入。

最近核验：2026-07-24。安装命令、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 已对照 Anthropic 官方文档。

1. 安装 Claude Code ​

原生安装（官方推荐） ​

原生安装支持后台自动更新。

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex
batch
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 原生运行需要 Git for Windows 或 WSL。

包管理器安装 ​

bash
brew install --cask claude-code
powershell
winget install Anthropic.ClaudeCode

Homebrew 和 WinGet 安装不会自动更新，需要分别执行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode。

验证安装：

bash
claude --version

最新平台要求见 Claude Code 安装文档。

2. 配置 Zivv 网关 ​

Claude Code 官方网关配置使用：

  • ANTHROPIC_BASE_URL：网关地址
  • ANTHROPIC_AUTH_TOKEN：网关 Bearer Token

Zivv 同时兼容 x-api-key 和 Authorization: Bearer，因此这里优先使用官方网关文档推荐的 ANTHROPIC_AUTH_TOKEN，不要同时设置 ANTHROPIC_API_KEY。

临时设置 ​

bash
export ANTHROPIC_BASE_URL="https://zivv.pro"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
claude
powershell
$env:ANTHROPIC_BASE_URL = "https://zivv.pro"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
claude
cmd
set ANTHROPIC_BASE_URL=https://zivv.pro
set ANTHROPIC_AUTH_TOKEN=sk-你的Key
claude

永久设置 ​

bash
echo 'export ANTHROPIC_BASE_URL="https://zivv.pro"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的Key"' >> ~/.zshrc
source ~/.zshrc
bash
echo 'export ANTHROPIC_BASE_URL="https://zivv.pro"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的Key"' >> ~/.bashrc
source ~/.bashrc
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://zivv.pro", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")

设置后重新打开终端和 Claude Code。ANTHROPIC_BASE_URL 不要追加 /v1/messages，客户端会自动拼接请求路径。

3. 验证配置 ​

启动 Claude Code 后执行 /status，确认网关地址为 https://zivv.pro。也可以直接测试：

bash
echo "只回复 pong" | claude -p --output-format text

返回正常文本后，到 用量日志 核对模型、Token 和状态码。

4. 选择模型 ​

Claude Code 的默认模型和别名会随版本变化。请从 模型广场 复制当前可用模型 ID，并确认 Key 分组允许访问。

临时指定模型：

bash
claude --model "模型广场中的模型 ID"

升级 Claude Code 后，应重新验证默认模型、工具调用、扩展思考和上下文能力。不要长期依赖文档中的固定模型版本。

故障排查 ​

401 或认证错误 ​

  • 确认只设置了 ANTHROPIC_AUTH_TOKEN，没有残留冲突的 ANTHROPIC_API_KEY
  • 检查 Key 是否完整、有效、未过期
  • 重新打开终端，确认新进程已读取环境变量
  • Key 轮换后完全退出并重启 Claude Code

连接失败或 404 ​

  • Base URL 使用 https://zivv.pro
  • 不要填写 https://zivv.pro/v1/messages
  • 用 curl https://zivv.pro/health 检查基础网络
  • 检查本地代理、防火墙和 HTTPS 证书拦截

模型不可用、402 或 403 ​

检查模型 ID、个人余额、Key 额度、模型权限和团队预算，详见 用量、额度与限流。

普通对话成功，但工具调用失败 ​

第三方网关必须正确处理 anthropic-version、anthropic-beta、流式事件和工具字段。Zivv 会处理已支持的 Anthropic 协议；具体能力仍取决于所选模型和当前网关版本。

官方资料 ​

Zivv — OpenAI / Anthropic / Gemini 多协议 AI Gateway

© 2026 Zivv