> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 第三方客户端接入

> Moxus AI兼容 OpenAI、Anthropic 与 Gemini 的接口协议，因此支持主流第三方客户端的接入。只需修改客户端的 Base URL 与 API Key，即可将这些客户端连接至Moxus AI，访问平台支持的所有模型。

Moxus AI兼容 OpenAI、Anthropic 与 Gemini 的接口协议，因此支持主流第三方客户端的接入。只需修改客户端的 Base URL 与 API Key，即可将这些客户端连接至Moxus AI，访问平台支持的所有模型。

本文档列举常见客户端的配置方法。

<Info>
  大多数 OpenAI 兼容客户端填写 `https://moxus.ai/v1`。如果客户端要求填写“接口域名”而不是“Base URL”，可尝试填写 `https://moxus.ai`。
</Info>

<Columns cols={3}>
  <Card title="桌面客户端" icon="monitor" href="#桌面端客户端">
    ChatBox、ChatGPT Next Web、OpenCat、ChatKit 等客户端配置方法。
  </Card>

  <Card title="浏览器插件" icon="panel-right" href="#浏览器插件">
    侧边栏、网页助手和浏览器扩展的自定义 API 配置方式。
  </Card>

  <Card title="编程工具" icon="terminal-square" href="#编程工具">
    Cursor 等开发工具连接 OpenAI 兼容接口的配置方式。
  </Card>
</Columns>

## 配置前提

在配置客户端前，请先在平台完成以下准备：

1. 注册账户并登录。
2. 充值或确认账户有可用额度。
3. 在 [账户与 API 密钥](/zh/platform/account-and-keys) 页面创建 API 密钥（形如 `sk-xxxxxx`）。

配置时需要以下两项信息：

| 项        | 值                                          | 备注                  |
| -------- | ------------------------------------------ | ------------------- |
| Base URL | `https://moxus.ai/v1` 或 `https://moxus.ai` | 根据客户端要求选择是否包含 `/v1` |
| API Key  | `sk-你的密钥`                                  | 在密钥页面创建             |

部分客户端可能在「模型列表」获取失败时提示报错。可分别尝试带 `/v1` 与不带 `/v1` 的两种写法。

<Tip>
  如果模型列表能加载但对话失败，请先在平台用量日志中查看失败原因。日志通常能区分密钥错误、额度不足、模型无权限和请求参数不兼容。
</Tip>

## 桌面端客户端

### ChatBox

ChatBox 是一款支持 Windows、macOS 与 Linux 的开源桌面客户端。

配置步骤：

1. 打开 ChatBox，进入设置页面。
2. 选择 AI 服务提供商为 OpenAI API（或自定义）。
3. 填写以下信息：
   * API 域名/Base URL：`https://moxus.ai/v1`
   * API Key：`sk-你的密钥`
4. 保存后，客户端将自动获取可用模型列表。
5. 选择所需模型后即可开始对话。

### ChatGPT Next Web

ChatGPT Next Web 可作为桌面应用或网页版使用。

配置步骤：

1. 打开设置。
2. 在接口配置中选择 OpenAI。
3. 填写以下信息：
   * 接口地址：`https://moxus.ai/v1`
   * API Key：`sk-你的密钥`
4. 保存后，在模型选择中可看到平台支持的模型。

### Chatbot UI

配置步骤：

1. 进入设置页面。
2. 选择 OpenAI 作为提供商。
3. 填写：
   * Base URL：`https://moxus.ai/v1`
   * API Key：`sk-你的密钥`
4. 保存并刷新模型列表。

### OpenCat（iOS）

OpenCat 是 iOS 平台的客户端。

配置步骤：

1. 打开 OpenCat，进入设置。
2. 选择自定义 API。
3. 填写：
   * API 地址：`https://moxus.ai/v1`
   * API Key：`sk-你的密钥`
4. 保存后可选择模型使用。

### ChatKit（Android）

配置步骤：

1. 打开设置。
2. 选择 OpenAI API。
3. 填写 Base URL 与 API Key。
4. 保存后选择模型即可使用。

## 浏览器插件

### ChatGPT Sidebar（Chrome/Edge）

该插件可在浏览器侧边栏调用模型。

配置步骤：

1. 安装插件后，点击设置图标。
2. 选择自定义 API。
3. 填写：
   * Base URL：`https://moxus.ai/v1`
   * API Key：`sk-你的密钥`
4. 保存后可在侧边栏中使用。

### Sider（多浏览器支持）

配置步骤与上述类似，均在插件设置中填写自定义 API 地址与密钥。

## 编程工具

### Cursor

Cursor 是一款 AI 编程编辑器。

配置步骤：

1. 打开 Cursor，进入 Settings → Models。
2. 在 OpenAI API Key 处填写Moxus AI密钥（`sk-你的密钥`）。
3. 在 Base URL 或 Override OpenAI Base URL 处填写 `https://moxus.ai/v1`。
4. 保存后，可在模型列表中选择平台支持的模型。

### Continue（VSCode/JetBrains 插件）

Continue 是一款代码补全与对话插件。

配置步骤（以 VSCode 为例）：

1. 安装 Continue 插件。
2. 打开 Continue 配置文件（`~/.continue/config.json` 或通过插件设置打开）。
3. 在 `models` 部分添加：

```json theme={null}
{
  "models": [
    {
      "title": "Moxus AI GPT-4",
      "provider": "openai",
      "model": "gpt-4o",
      "apiKey": "sk-你的密钥",
      "apiBase": "https://moxus.ai/v1"
    }
  ]
}
```

4. 保存后重启插件，即可在对话中选择该模型。

### GitHub Copilot（通过代理）

GitHub Copilot 本身不支持自定义 API。如需接入Moxus AI，可使用第三方代理工具（如 `copilot-gpt4-service`）将 Copilot 请求转发至Moxus AI，但此类方案可能违反 GitHub Copilot 服务条款，使用时需自行承担风险。

## 通用配置建议

多数客户端配置流程类似，核心步骤为：

1. 在设置中找到 API 配置项。
2. 选择 OpenAI 或自定义 API 作为提供商。
3. 填写 Base URL 与 API Key。
4. 保存后刷新模型列表。

若遇到「模型列表获取失败」，可尝试以下方法：

* 调整 Base URL：尝试 `https://moxus.ai/v1` 与 `https://moxus.ai` 两种写法。
* 检查密钥是否正确及是否包含 `Bearer ` 前缀（多数客户端会自动添加，手动填写时无需加）。
* 确认账户余额充足。
* 查看平台 [用量日志](/zh/platform/dashboard-and-usage)，确认请求是否到达及失败原因。

## 后续步骤

* 了解编程集成方式：参阅 [SDK 集成](/zh/integrations/sdks)。
* 快速调试接口：参阅 [体验场](/zh/platform/playground)。