# CLI 工具指南

本页说明如何把 WebberAI 接入常见命令行 AI 工具。核心参数是 API Key、Base URL 和模型 ID。

## 通用参数

| 项目 | 推荐值 |
| --- | --- |
| Provider | `OpenAI Compatible` 或工具里的自定义 OpenAI 服务商 |
| API Key | WebberAI [API Keys](https://webberai.top/keys) 页面创建的密钥 |
| Base URL | `https://webberai.top/v1` |
| Model | 从 [模型广场](https://webberai.top/models) 复制的模型 ID |

如果工具会自动追加 `/v1`，Base URL 改为 `https://webberai.top`。

## 推荐流程

1. 为 CLI 工具单独创建 API Key。
2. 在 [模型广场](https://webberai.top/models) 选择模型 ID。
3. 优先打开 [API Keys](https://webberai.top/keys) 页面的“使用密钥 / Use Key”弹窗，复制站内生成的配置。
4. 保存配置后重启 CLI。
5. 发送短任务验证，例如“输出当前目录结构”。

## Codex

详见 [Codex 使用指南](/docs/agents/codex)。

核心配置：

```toml
[model_providers.webberai]
name = "WebberAI"
base_url = "https://webberai.top/v1"
wire_api = "responses"
requires_openai_auth = true
```

## Claude Code

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

Claude Code 的可用配置取决于当前 API Key 支持的平台类型。优先使用 WebberAI 密钥页生成的配置，不要强行套用 OpenAI 兼容地址。

## OpenCode

详见 [OpenCode 使用指南](/docs/agents/opencode)。

在 OpenCode 中新增 OpenAI Compatible 服务商，填写 WebberAI API Key、Base URL 和模型 ID。

## CC-Switch

详见 [CC-Switch](/docs/agents/cc-switch)。

适合同时使用多个 Agent 客户端的场景，可以统一管理 WebberAI、模型和密钥。

## 常见错误

- `401` 或 `INVALID_API_KEY`：重新复制 API Key，确认没有空格或换行。
- `404`：检查是否重复写了 `/v1/v1`。
- 模型不存在：从模型广场复制模型 ID，不要手写猜测。
- 没有响应：先用 [OpenAI 兼容 API](/api/openai) 的 `curl` 示例验证接口。