---
title: "Cline"
description: "在 Cline 里把 API Provider 选成 OpenAI Compatible，Base URL 填 https://api.pirouter.ai/v1，再填 pirouter 的 API key 和模型 ID，扩展和 CLI 就都走 pirouter。"
canonical: "https://pirouter.ai/zh/docs/integrations/cline"
last-updated: "2026-10-18"
lang: "zh"
source: "content/docs/zh/integrations/cline.mdx"
---

# Cline

在 Cline 里把 API Provider 选成 OpenAI Compatible，Base URL 填 https://api.pirouter.ai/v1，再填 pirouter 的 API key 和模型 ID，扩展和 CLI 就都走 pirouter。

[Cline](https://github.com/cline/cline) 用 **OpenAI Compatible** 这个 provider 接入 pirouter：Base URL 填 `https://api.pirouter.ai/v1`，API Key 填 pirouter 的 key，Model ID 填 pirouter 的完整模型 ID。不需要 Cline 账号。VS Code 扩展和 Cline CLI 共用同一份配置，在一边配好，另一边也能用。

## 前提

- 一个 pirouter API key。还没有的话，按[快速开始](https://pirouter.ai/zh/docs/quickstart.md)创建一个，并存进环境变量：

```bash
export PIROUTER_API_KEY="sk-pi-..."
```

- 下面两种装一种：
  - VS Code 里装好 Cline 扩展。
  - Cline CLI：需要 Node.js 20 及以上，用 `npm install -g cline` 安装。本页的 CLI 部分按 Cline CLI 3.0.73 验证。

## 配置

请求发到 `POST /v1/chat/completions`。能用哪些模型，见[模型与协议](https://pirouter.ai/zh/docs/models.md#每个模型接受哪些协议)的协议表里 OpenAI 一列，Claude、GPT 和 Gemini 都在其中。

### VS Code 扩展

1. 打开 Cline 侧栏，点 ⚙️ 进入设置。
2. **API Provider** 选 **OpenAI Compatible**。
3. **Base URL** 填 `https://api.pirouter.ai/v1`。填到 `/v1` 为止，不要加 `/chat/completions`。
4. **API Key** 填你的 pirouter key。
5. **Model ID** 填完整模型 ID，例如 `anthropic/claude-sonnet-5.5`。

![示意图：Cline 设置面板，API Provider 为 OpenAI Compatible，Base URL 为 https://api.pirouter.ai/v1，Model ID 为 anthropic/claude-sonnet-5.5](/docs/shots/cline-settings.zh.svg)

上图是按 Cline 官方文档绘制的扩展设置界面示意图，不是真实截图，实际界面以你安装的版本为准。

### Cline CLI

在设置了 `PIROUTER_API_KEY` 的终端里运行一次：

```bash
cline auth -p openai-compatible -k "$PIROUTER_API_KEY" -m anthropic/claude-sonnet-5.5 -b https://api.pirouter.ai/v1
```

这条命令把 provider、Base URL、key 和模型写进 `~/.cline/data/settings/providers.json`。VS Code 扩展读的也是这个文件，所以 CLI 配好以后，扩展里也是同一套设置。key 会以明文存在这个文件里，不要把它提交进代码仓库或分享出去。

## 验证

用 CLI 运行：

```bash
cline --json "Reply with exactly: OK"
```

你应该看到每行一个 JSON 事件，其中 `type` 为 `run_result` 的那一行，`finishReason` 是 `completed`，模型的回复是 `OK`。

在 VS Code 扩展里验证的话，在 Cline 侧栏发一句 `Reply with exactly: OK`，回复是 `OK` 即可。

在控制台[日志](https://pirouter.ai/zh/docs/guides/logs.md)里能看到这次请求，**端点** 一栏是 `/v1/chat/completions`。

## 排障

### Anthropic provider 填不了自定义地址

在 CLI 上用 `cline auth -p anthropic` 加 `-b` 指定地址时，CLI 直接报错：

```text
error: base URL is only supported for OpenAI and OpenAI-compatible providers
```

`https://api.pirouter.ai` 和 `https://api.pirouter.ai/v1` 都是这个结果。Claude 模型也用 OpenAI Compatible 接入，按上面的配置填即可。

### GPT 系列模型返回 400

GPT 系列模型在同一个请求里同时带工具和 `reasoning_effort` 时，可能被上游拒绝，返回 `400` 和 "Function tools with reasoning\_effort are not supported"。Cline 的任务几乎都带工具，遇到时关掉思考，例如 CLI 上加 `--thinking none`，或者换一个模型。

### 模型在回复里写工具调用的文字，而不是真的调用工具

Cline 4.1.11 出现过一次回归：自定义模型的能力配置里没有工具时，Cline 不在请求里带工具定义，模型只能在回复里自己编工具调用的文字。把 Cline 升级到最新版本；仍然出现的话，删掉 `~/.cline/data/settings/providers.json` 让 Cline 重建，再按上面的步骤重新配置一次。

## 目前没有验证的用法

- VS Code 扩展的设置界面本身。本页的扩展步骤按 Cline 官方文档写，请求链路用 CLI 验证过，两者共用同一份配置。
- 扩展里 API Provider 选 **Anthropic** 并勾选自定义 base URL，走 `/v1/messages` 接入 pirouter。

## 相关链接

- [Cline](https://github.com/cline/cline)（GitHub）
- [Cline 扩展](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)（VS Code Marketplace）
- [OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)：Cline 文档里 OpenAI Compatible provider 的设置
- [CLI 参考](https://docs.cline.bot/cli/cli-reference)：`cline auth` 与运行参数
- [配置文件](https://docs.cline.bot/getting-started/config)：`~/.cline` 目录与 `providers.json`