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

# Cline 集成

> 在 Cline 中配置 APIAny.AI API Key、Base URL 和推荐模型。

[Cline](https://cline.bot/) 可以通过 OpenAI 兼容配置接入 APIAny.AI。完成配置后，你可以在同一个客户端中使用对话、推理、翻译和多模态模型。

## 准备工作

* 已安装 Cline。
* 已在 [APIAny.AI 控制台](https://apiany.ai/zh/dashboard/api-keys) 创建 API Key。
* 已准备一个要使用的模型 ID，例如 `gpt-5.4-mini` 或 `gpt-4o-mini`。

## 配置值

| 字段       | 填写内容                   |
| -------- | ---------------------- |
| API mode | `OpenAI Compatible`    |
| Base URL | `https://apiany.ai/v1` |
| API Key  | 你的 APIAny.AI API Key   |
| 模型       | `gpt-5.4`              |

## 配置步骤

1. 在 VS Code 中安装并打开 Cline。
2. 进入 Cline 设置，选择 OpenAI Compatible。
3. 填写 Base URL、API Key 和模型 ID。
4. 保存后让 Cline 执行一个小型代码任务验证连接。

## 推荐模型

| 模型 ID               | 适用场景                        |
| ------------------- | --------------------------- |
| `gpt-5.5`           | 适合复杂推理、编码和生产级工作流，优先推荐。      |
| `gpt-5.4`           | 适合高级对话、Agent 和通用生产任务。       |
| `gpt-5.4-mini`      | 速度、质量和成本均衡，适合日常高频使用。        |
| `gpt-4o-mini`       | 适合简单对话、翻译和轻量任务，速度快、成本低。     |
| `claude-sonnet-4-6` | 适合 Claude 兼容配置的长文本、写作和编码任务。 |
| `gemini-3.5-flash`  | 适合 Gemini 兼容配置的快速多模态任务。     |

## 操作截图

以下截图展示 Cline 中的关键配置入口和保存后的使用界面。截图中的 API 地址和名称均已按 APIAny.AI 调整。

### 步骤 1

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cline/extension-install.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=1e0908371b3de33c9538f0afebc53b94" alt="Cline 配置截图 1" width="1510" height="1010" data-path="images/integrations/cline/extension-install.png" />

### 步骤 2

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cline/sidebar-settings.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=2809e9fb0d367cd949cad60c7cfb14dd" alt="Cline 配置截图 2" width="1919" height="1031" data-path="images/integrations/cline/sidebar-settings.png" />

### 步骤 3

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cline/api-config.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=db89840d408ace7e7f40ee1e11305b63" alt="Cline 配置截图 3" width="1920" height="1031" data-path="images/integrations/cline/api-config.png" />

### 步骤 4

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cline/chat-interface.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=6fdf536d542526331879855ec4a03f27" alt="Cline 配置截图 4" width="1920" height="1031" data-path="images/integrations/cline/chat-interface.png" />

### 步骤 5

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cline/code-refactor.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=722af084c5eacfafcd8acb0e3ab81482" alt="Cline 配置截图 5" width="1920" height="1031" data-path="images/integrations/cline/code-refactor.png" />

## 常见问题

### 返回 401 或认证失败

确认 API Key 已完整复制，前后没有多余空格，并且已经在 APIAny.AI 控制台中启用。

### 模型无法选择或调用失败

手动输入模型 ID，并确认该模型在 [模型目录](/zh/models/chat-models) 中可用。不同工具可能不会自动拉取模型列表。

### Base URL 应该怎么填

OpenAI 兼容配置通常使用 `https://apiany.ai/v1`；Claude 兼容配置通常使用 `https://apiany.ai`；需要完整接口地址的工具使用 `https://apiany.ai/v1/chat/completions`。