Cline 是一个开源的 AI 编程助手，能读代码、改文件、运行命令，每一步都可以先让你确认。它有 VS Code、Cursor、JetBrains 等编辑器插件，也有命令行版和桌面版，可以接各家模型服务和你自己的 API Key。

插件和命令行版免费。模型要付费：用你自己的 API Key、Cline 官方的按量计费，或者 ClinePass 包月（每月 9.99 美元）。Cline 也会不定期提供限时免费模型，需要登录 Cline 账号。

Cline 怎么接第三方 API 或中转站？

插件里在设置中把 API Provider 选成 OpenAI Compatible，填 Base URL、API Key 和 Model ID。命令行版运行 cline auth -p openai-compatible -k 密钥 -m 模型名 -b 地址。OpenAI 兼容的地址一般要带 /v1。

Cline 命令行能给 Claude 接口设自定义地址吗？

不能。Cline CLI 3.0.71 的 cline auth 只允许 OpenAI 和 OpenAI 兼容类服务商设自定义地址，给 Anthropic 设会报错。插件里的 Anthropic 有「Use custom base URL」选项可以用。

安装 Cline 命令行需要什么？

需要 Node.js 20 或以上（推荐 22），然后运行 npm install -g cline。国内网络可以加 --registry=https://registry.npmmirror.com 使用国内镜像。

Cline 安装与配置教程（2026）：VS Code 插件和 Cline CLI 接入任意 API

一句话说清：

编辑器里用：在扩展商店搜 Cline 安装，点 Cline 面板上的 ⚙️ 选 API Provider。
终端里用：npm install -g cline 装好后运行 cline auth。

接第三方 API，选 OpenAI Compatible，填 Base URL、API Key、Model ID 三项。命令行一行就能配好：cline auth -p openai-compatible -k 密钥 -m 模型名 -b 地址。

本文的命令行部分在 2026 年 10 月 15 日用 Cline CLI 3.0.71 实测过，输出都是真实结果。

Cline 是什么

Cline 是一个开源的 AI 编程助手。和 Claude Code 类似，它能读项目、改代码、跑命令，区别是默认每一步都先给你看、等你点同意，适合想把控过程的人。它有三种形态：

形态	在哪用	说明
编辑器插件	VS Code、Cursor、Windsurf、VSCodium、JetBrains	最常用；Windsurf、VSCodium 从 Open VSX 安装
Cline CLI	任意终端	交互界面，也能无界面运行，适合脚本和 CI
Cline Desktop	macOS、Windows（测试版）	桌面应用，主打开源模型

模型从哪来，有三种选择：

Cline 官方按量计费：充 Cline 的额度用。
ClinePass：每月 9.99 美元，主要用于常用的开源编程模型。
用你自己的 API Key：Anthropic、OpenAI、Gemini、DeepSeek、智谱、OpenRouter、任何 OpenAI 兼容的服务，或者 Ollama、LM Studio 本地模型。

安装编辑器插件

按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows）打开扩展商店。
搜索 Cline，点「安装」。
在侧边栏打开 Cline，点 ⚙️ 选择服务商。

JetBrains 系列：Settings → Plugins → Marketplace 搜 Cline 安装，然后重启 IDE。

安装 Cline 命令行

需要 Node.js 20 或以上（推荐 22），国内网络加上镜像：

npm install -g cline --registry=https://registry.npmmirror.com

我们实测 14 秒装完，装完约占 360 MB，比 Claude Code、Codex 都大：

added 330 packages in 14s

检查版本：

cline --version

3.0.71

接入模型服务

插件里怎么配

点 Cline 面板上的 ⚙️，在 API Provider 里选一个：

服务商	要填什么	说明
Anthropic	Anthropic API Key、模型	可勾选 Use custom base URL 填中转地址
OpenAI	API Key，或用 Codex 账号登录
OpenAI Compatible	Base URL、API Key、Model ID	接任何 OpenAI 兼容服务都用这个；填完点 Verify 测试
Claude Code	本机 `claude` 命令的路径	用你的 Claude Pro / Max 订阅，不按 API 计费

选 OpenAI Compatible 时，下面的 Model Configuration 可以填模型的上下文长度、最大输出、是否支持图片和单价。Cline 靠这些数字计算上下文用量和费用，最好照模型的真实参数填。

命令行：一行配好

cline auth 可以直接带参数，不用交互，换电脑、写脚本都方便。以 api.foo 为例：

cline auth -p openai-compatible -k "sk-你的密钥" -m gpt-6.1-sol -b https://api.foo/v1

Provider configured: openai-compatible (gpt-6.1-sol)

我们用一把故意写错的密钥跑了一个任务，Cline 把请求发到了 api.foo，并收到了 api.foo 的回复：

cline --json "say hi"

{"type":"error","message":"无效的令牌 (request id: …)"}

api.foo 服务器日志里收到的是 POST /v1/chat/completions，说明地址拼接正确，换上正确的密钥就能用。

实测踩到的两个坑：

命令行版只有 OpenAI 类服务商能设自定义地址。给 Anthropic 设会直接报错：
```
error: base URL is only supported for OpenAI and OpenAI-compatible providers
```
想在命令行里通过中转用 Claude，就选 openai-compatible，地址填中转的 /v1，模型填 Claude 的模型名。插件版的 Anthropic 支持自定义地址，没有这个限制。
没配好自己的服务商时，Cline 会默认用它自己的服务商，报错：
```
Unauthorized: Please make sure you're using the latest version of Cline and re-authenticate your Cline account.
```
看到这句不是你的密钥有问题，而是根本没用上你的配置。重新运行 cline auth，再用 cline config 确认当前用的是哪个服务商。

配置文件在哪

命令行版的数据默认在 ~/.cline：

服务商和密钥：~/.cline/data/settings/providers.json
日志：~/.cline/data/logs/cline.log，运行 cline doctor log 可以直接打开。

想换位置用 --config <目录> 或环境变量 CLINE_DIR；想完全隔离一套配置（比如测试），用 --data-dir <目录>。

命令行常用操作

命令	作用
`cline`	在当前文件夹开始交互对话
`cline "任务"`	直接执行一个任务
`cline -p "任务"`	先出计划（Plan 模式），再动手
`cline --json "任务"`	无界面输出 JSON，适合脚本
`git diff \| cline "审查这些改动"`	把内容通过管道交给 Cline，会自动进入无界面模式
`cline --auto-approve true "任务"`	不再逐步确认。只在干净的分支上用
`cline config`	查看当前配置
`cline doctor`	诊断配置问题
`cline history`	查看历史任务
`cline mcp`	管理 MCP 服务

常见问题与解决办法

报错或现象	原因	解决
`Invalid API Key`、401、无效的令牌	密钥错了，或者密钥和地址不是同一家	从同一家服务商重新复制密钥
`Model Not Found`、模型不存在	模型名在这个地址上不存在	到服务商的模型列表复制完整模型名
连不上、超时	地址写错，或网络被拦	检查地址，OpenAI 兼容服务一般以 `/v1` 结尾
`base URL is only supported for OpenAI …`	命令行里给非 OpenAI 类服务商设了 `-b`	改用 `openai-compatible`，或用插件版
`Unauthorized: … re-authenticate your Cline account`	用的是 Cline 自己的服务商，不是你配的	重新 `cline auth`，用 `cline config` 确认

更多报错见报错排查大全。