# Claude API

本页说明 WebberAI 与 Claude / Anthropic 协议工具的接入原则。具体可用入口以 WebberAI [API Keys](https://webberai.top/keys) 页面生成的配置为准。

## 适用场景

- Claude Code
- 支持 Anthropic API 的 CLI 或 IDE 插件
- 需要 Claude Messages 协议的自定义工具

## 配置原则

1. 在 WebberAI 创建 API Key。
2. 打开该密钥的“使用密钥 / Use Key”弹窗。
3. 如果弹窗提供 Claude / Anthropic 配置，复制其中的 Base URL 和环境变量。
4. 如果没有 Claude 配置，说明当前密钥或平台未开放该协议，优先改用 [OpenAI 兼容 API](/api/openai)。

## Claude Code

详见 [Claude Code 使用指南](/docs/agents/claude-code)。

常见环境变量形式如下，但实际值应以 WebberAI 密钥页为准：

```bash
export ANTHROPIC_AUTH_TOKEN="YOUR_WEBBERAI_API_KEY"
export ANTHROPIC_BASE_URL="以 WebberAI 密钥页生成的地址为准"
```

Windows PowerShell：

```powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_WEBBERAI_API_KEY"
$env:ANTHROPIC_BASE_URL="以 WebberAI 密钥页生成的地址为准"
```

## 与 OpenAI 兼容 API 的区别

OpenAI 兼容 API 的 Base URL 是：

```text
https://webberai.top/v1
```

Claude / Anthropic 协议工具不一定接受这个地址。协议、Header、端点路径和消息格式可能不同，因此不要直接混用。

## 排查

- 认证失败：重新复制密钥，确认环境变量名正确。
- 404：Base URL 或协议端点不匹配。
- 模型不存在：确认当前模型是否支持 Claude / Anthropic 协议。
- 工具启动失败：先移除自定义配置，按 WebberAI 密钥页生成内容重新填写。