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

# Cline、Roo Code、WorkBuddy 接入 Global AI 指南

> 在 VS Code、Cursor 与 Trae 中通过 Cline、Roo Code、WorkBuddy 等编程 Agent 插件接入 Global AI，并了解 Cursor 与 Trae 的适配限制。

Cline、Roo Code、WorkBuddy 等编程 Agent 都可以在编辑器插件中直接接入 Global AI，用它们替代 Cursor 与 Trae 原生 Agent 是常见做法。

<Warning>
  Agent 类工具依赖大量 Token 运行。使用前建议阅读 [接入总览的费用提示](/clients/overview#关于-claude-模型费用)，并在 [日志](/usage/logs) 中留意消耗。
</Warning>

## Cursor 与 Trae 的限制

<CardGroup cols={2}>
  <Card title="Cursor">
    三方 API（含 Global AI）只支持 Ask 模式，**无法使用原生 Agent**。需要 Agent 时可在 Cursor 里安装 [Claude Code](/clients/claude-code)、Cline 或 Roo Code。
  </Card>

  <Card title="Trae">
    自身不支持第三方 API，**无法把 Global AI 密钥直接填入模型配置**。需要 Agent 时请安装 [Claude Code](/clients/claude-code) 使用。
  </Card>
</CardGroup>

## Cline

Cline 是 VS Code / Cursor 上最流行的编程 Agent 插件之一。

<Steps>
  <Step title="安装 Cline">
    在 VS Code 或 Cursor 的插件市场搜索 **Cline**，选择第一个结果安装。
  </Step>

  <Step title="配置提供商">
    打开 Cline 侧边栏，进入设置，按下面内容填写：

    * **API Provider**：`Anthropic`
    * **Base URL**：`https://globalai.vip`
    * **API Key**：粘贴你的 `sk-` 令牌
    * **Model ID**：如 `claude-sonnet-4-5`
  </Step>

  <Step title="测试">
    点击「Let's go!」按钮发起测试对话，模型正常响应即接入成功。
  </Step>
</Steps>

## Roo Code

Roo Code 的配置流程与 Cline 几乎一致，也是 Cursor / VS Code 上常用的 Agent 插件。

<Steps>
  <Step title="配置 Anthropic 提供商">
    与 Cline 相同：

    * **API Provider**：`Anthropic`
    * **Base URL**：`https://globalai.vip`
    * **API Key**：`sk-` 令牌
    * **Model**：如 `claude-sonnet-4-5`
  </Step>

  <Step title="接入国产模型（可选）">
    如需在 Roo Code 中调用 DeepSeek 等国产模型，把 API Provider 改为 **OpenAI Compatible**，**Base URL** 填 `https://globalai.vip/v1`，其余按国产模型 ID 填写即可。
  </Step>
</Steps>

## WorkBuddy

WorkBuddy 是一款独立的 AI 编程助手。下载地址：[codebuddy.cn](https://www.codebuddy.cn/)。

<Steps>
  <Step title="登录并进入设置">
    下载安装并登录后，点击左下角头像，选择「设置」。
  </Step>

  <Step title="添加自定义提供商">
    在左侧「模型」选项卡按以下内容填写：

    * **提供商**：选择「自定义」
    * **接口地址**：`https://globalai.vip/v1/chat/completions`
    * **API Key**：粘贴你的 `sk-` 令牌
    * **模型名称**：从 [定价页](https://globalai.vip/pricing) 复制目标模型 ID
    * **高级设置**：建议至少勾选「工具调用」「图片输入」「思考模式」

    其他保持默认，点击保存。
  </Step>

  <Step title="选择模型并测试">
    返回主界面，在输入框下方选择刚添加的模型，发送一条消息进行测试。模型正常回复即接入成功。
  </Step>
</Steps>

## 常见问题

<AccordionGroup>
  <Accordion title="Cursor 里能不能用 Agent？">
    不能直接用 Cursor 原生 Agent。可以在 Cursor 内安装 Claude Code、Cline 或 Roo Code 插件替代。
  </Accordion>

  <Accordion title="调用 Claude 时费用增长快">
    Agent 每一轮都会重发历史 Token，长会话或大代码库上下文尤其明显。请阅读 [Claude 费用说明](/clients/overview#关于-claude-模型费用) 并在 [日志](/usage/logs) 中观察消耗。
  </Accordion>

  <Accordion title="连接失败 / 超时">
    请关闭一切代理与科学上网工具，Global AI 国内直连不需要代理。
  </Accordion>
</AccordionGroup>


## Related topics

- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [Global AI 常见问题：账号、令牌、调用与计费](/faq.md)
- [OpenCode 与 CC-Switch 接入 Global AI 指南](/clients/opencode.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/clients/chatwise.md)
- [Claude Code 接入 Global AI：Windows、macOS 与 Linux 配置](/clients/claude-code.md)