# 快速开始

::: tip 访问入口
WebberAI 主站地址：[https://webberai.top](https://webberai.top)

OpenAI 兼容 API 基础地址：`https://webberai.top/v1`
:::

本页用于完成 WebberAI 的首次接入。你可以按自己的使用场景选择 `API`、`Agent` 或 `ChatBot` 方式开始。

::: details For AGENTS
批量读取 Markdown 文档时，可直接使用 [markdown-sitemap.xml](/markdown-sitemap.xml)。单页读取时，在不以 `/` 结尾的文档 URL 后追加 `.md` 即可，例如 `/docs/quickstart.md`。
:::

## 开始前确认

1. 前往 [注册页面](https://webberai.top/register) 创建账号，并按提示完成邮箱验证。
2. 前往 [API Keys](https://webberai.top/keys) 创建一个新的 API Key。
3. 前往 [模型广场](https://webberai.top/models) 查看可用模型、平台类型与价格。
4. 如需充值，进入 [Purchase](https://webberai.top/purchase)；如已有兑换码，进入 [Redeem](https://webberai.top/redeem)。

## 选择接入方式

### API

适合已有应用、脚本或后端服务，需要直接调用模型接口的用户。

推荐先阅读 [API 总览](/api/)，再根据目标协议选择：

- [OpenAI 兼容 API](/api/openai) - 适合大多数 SDK、桌面客户端和 Agent 工具。
- [Claude API](/api/claude) - 适合需要 Anthropic / Claude 兼容协议的工具。
- [Gemini API](/api/gemini) - 适合需要 Gemini 兼容协议的工具。

如果不确定选哪个，优先使用 OpenAI 兼容 API。

### Agent

适合在终端工作、有编程需求，或希望使用 AI Agent 辅助开发的用户。

推荐优先从 WebberAI 的 [API Keys](https://webberai.top/keys) 页面打开对应密钥的“使用密钥 / Use Key”弹窗，复制系统生成的配置。后台生成的配置会包含当前密钥支持的平台、默认接口地址和客户端示例。

常用入口：

- [CC-Switch](/docs/agents/cc-switch) - 统一管理多客户端的 API Key 与供应商配置。
- [Codex](/docs/agents/codex) - 代码生成、修改和审查场景。
- [Claude Code](/docs/agents/claude-code) - 终端 Agent 工作流。
- [OpenCode](/docs/agents/opencode) - 轻量终端编码 Agent。

### ChatBot

适合偏好图形界面、移动端或以日常对话为主要使用场景的用户。

推荐客户端：

- [Cherry Studio](/docs/chatbot/cherry-studio) - 桌面端，支持 Windows、macOS 和 Linux。
- [RikkaHub](/docs/chatbot/rikkahub) - Android 端，适合移动设备使用。

配置时通常选择 `OpenAI` 或 `OpenAI Compatible` 服务商，填入：

```text
API Key: 你在 WebberAI 创建的 API Key
Base URL: https://webberai.top/v1
```

如果客户端会自动拼接 `/v1`，则把地址改为 `https://webberai.top`，避免出现重复的 `/v1/v1`。

## 下一步

- [API 总览](/api/)
- [CLI 工具指南](/docs/cli-tools)
- [IDE 插件指南](/docs/ide-plugins)
- [余额与计费](/docs/webberai/billing)
- [故障排查](/docs/troubleshooting)