> ## 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 接入 Global AI 指南

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

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

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

## Cursor 与 Trae 的限制

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

  <Card title="Trae">
    自身不支持第三方 API，**无法把 Global AI 密钥直接填入模型配置**。需要 Agent 时请安装 [Claude Code](/zh/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>

## 常见问题

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

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

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


## Related topics

- [OpenCode 与 CC-Switch 接入 Global AI 指南](/zh/clients/opencode.md)
- [WorkBuddy 接入 Global AI：自定义提供商配置指南](/zh/clients/workbuddy.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/zh/clients/chatwise.md)
- [Claude Code 接入 Global AI：CC Switch 与手动配置](/zh/clients/claude-code.md)
- [Global AI 客户端接入总览：常用参数与选型](/zh/clients/overview.md)