工具接入
这一组文档用于把 MaoLao API 接入常见客户端和开发工具。新手不要从软件下载表开始乱点，建议先看 怎么选工具，确定自己要配置哪一类软件。
先走这条新手路线
| 顺序 | 要做什么 | 对应页面 |
|---|---|---|
| 1 | 按聊天、写代码、VS Code、自部署等用途选择教程 | 怎么选工具 |
| 2 | 为每个软件单独创建 API Key，方便排查和控制额度 | 创建 API Key |
| 3 | 先弄懂 Base URL、API Key、Model 三个核心字段 | OpenAI Compatible |
| 4 | 遇到无响应、模型不存在、频繁断线时按清单排查 | 常见问题排查 |
通用填写规则
除非单页特别说明，默认使用 OpenAI 兼容配置：
| 配置项 | 推荐值 |
|---|---|
| Base URL | https://api.maolaoapi.cc/v1 |
| 备用 Base URL | https://api.maolaoapi.com/v1 |
| API Key | 控制台令牌页创建的 Key |
| 模型名 | 根据目标软件支持的模型填写 |
接入前建议先完成三件事：
- 在 创建 API Key 页面创建独立 Key。
- 在对应软件教程中确认接口格式、模型填写位置和分组要求。
- 第一次配置时优先使用
auto分组，跑通后再按工具单独拆 Key。
小白图文配置方法
每篇软件教程都按这个方式读：
- 先看下载地址，确认软件来源。
- 再看准备工作，把 Key、Base URL、模型 ID 准备好。
- 对照图片逐步填写，不要跳过中间步骤。
- 保存后只发一句“请回复 ok”测试。
- 失败时先看本页底部排查顺序，再看对应软件的常见问题。
软件下载地址速查
优先从官网或官方 GitHub 下载，不建议从第三方软件下载站下载。
| 软件 | 官方下载地址 | 新手建议 |
|---|---|---|
| Claude Code | Claude Code 安装文档 | 按官方文档安装命令行工具 |
| Claude Coworks | Claude 官网 / 下载页 | 更新到支持开发者模式和第三方推理供应商的版本 |
| Codex CLI | Codex CLI 官方文档 / GitHub | 先看官方文档，再按系统安装 |
| OpenCode | opencode.ai / GitHub | 适合命令行或代码智能体场景 |
| Cherry Studio | GitHub Releases | 下载最新稳定版 |
| Chatbox | chatboxai.app | 官网会提供 Windows、macOS、Linux 和移动端 |
| GitHub Copilot | 官方快速开始 | 不能直接填写 MaoLao API Key |
| Zed Editor | zed.dev/download | 安装后在设置里找 AI / Provider |
| Cline | cline.bot / VS Code 扩展 | 适合 VS Code 用户 |
| Open WebUI | 安装文档 / GitHub | 适合 Docker 或服务器部署 |
| CodeBuddy | codebuddy.ai/ide | 下载 CodeBuddy IDE 或按官方文档安装插件 |
| Trae | trae.ai/download | 进入下载中心选择对应系统 |
| CC Switch | 官网 / GitHub Releases | 只从官网或官方 GitHub 下载 |
| LlamaIndex | 官方文档 / GitHub | 开发框架，不是聊天客户端 |
| BotGem | botgem.com | 看当前版本是否支持自定义 API |
| WorkBuddy | 官方入口 | 企业版可能限制自定义 Provider |
| LobeHub / LobeChat | lobehub.com / GitHub | 适合网页聊天或自部署 |
| OpenCat | opencat.app | 移动端和桌面端能力可能不同 |
| NextChat | nextchat.club / GitHub | 适合网页版使用或自部署；新手优先用官方网页 |
快速判断用哪个教程
| 你要接入的工具 | 看哪一页 |
|---|---|
| 通用 OpenAI 接口、自写代码 | OpenAI Compatible |
| Claude Code | Claude Code |
| Claude Coworks | Claude Coworks |
| Codex CLI | Codex CLI |
| OpenCode | OpenCode |
| Cherry Studio | Cherry Studio |
| Chatbox | Chatbox |
| GitHub Copilot | GitHub Copilot |
| Zed Editor | Zed Editor |
| Cline | Cline |
| Open WebUI | Open WebUI |
| CodeBuddy | CodeBuddy |
| Trae | Trae |
| CC Switch | CC Switch |
| BotGem | BotGem |
| WorkBuddy | WorkBuddy |
| LobeHub / LobeChat | LobeHub / LobeChat |
| OpenCat | OpenCat |
| NextChat | NextChat |
| Hermes / OpenClaw 遇到 403 | Hermes / OpenClaw 403 代理 |
| LangChain、OpenAI SDK、脚本开发 | LangChain / SDK |
| LlamaIndex 知识库开发 | LlamaIndex / SDK |
通用排查顺序
如果接入失败，先按这个顺序查：
- Base URL 是否带
/v1。 - API Key 是否来自 MaoLao API 控制台，复制时没有空格。
- 模型名是否完整一致。
- 当前 Key 的分组是否支持该模型。
- 客户端选择的是 OpenAI、Anthropic 还是其他接口格式。