CLI 工具指南

本页说明如何把 WebberAI 接入常见命令行 AI 工具。不同工具的配置格式不同，但核心参数一致。

通用参数

项目	推荐值
Provider	OpenAI Compatible 或对应工具中的自定义 OpenAI 服务商
API Key	WebberAI API Keys 页面创建的密钥
Base URL	https://webberai.top/v1
Model	从 模型广场 复制的模型 ID

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

推荐流程

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

Codex

详见 Codex 使用指南。

核心配置：

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

OpenCode

详见 OpenCode 使用指南。

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

Claude Code

详见 Claude Code 使用指南。

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

CC-Switch

详见 CC-Switch。

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

常见错误

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