Cline 登录配置：4 种方式获取密钥并填对位置

截至 2026 年 10 月 18 日，Cline 官方鉴权文档已把接入方式明确区分为 Cline 账号登录、ClinePass、自带密钥和本地模型四条路径。现在最值得厘清的是它们分别用不用 API 密钥，以及该把密钥填进扩展、CLI，还是 Cline API 请求头。下文凡标注“按官方口径推下来”的内容均为操作判断，其余功能与入口均出自官方页面。

开始前准备三样东西

1. 安装 Cline。 使用 VS Code 或 JetBrains 时，从对应扩展市场安装；使用命令行时执行以下官方命令，安装后运行 cline --version 查看是否能正常输出版本信息。

npm i -g cline

2. 决定是否使用 Cline 账号。 Cline 账号登录可使用 Google、GitHub 或邮箱完成 OAuth；这种方式不要求手动配置第三方 API 密钥，但登录后产生的费用按 Cline 的用量计费规则结算。

3. 准备密钥或本地运行环境。 自带密钥模式需要先从所选模型提供商的官方控制台取得 API 密钥；Ollama 或 LM Studio 模式不需要密钥，但对应服务必须已经在本机启动。

打开设置：密钥究竟填在哪里

在 VS Code 或 JetBrains 中打开 Cline 面板，点击面板内的齿轮图标 Settings，在 API Provider 下拉框中选择实际使用的模型提供商。随后会出现 API Key 输入框；只有自带密钥模式需要在这里粘贴密钥。

这里最容易混淆的是 Cline 自己的 API 与模型提供商的 API：

如果通过脚本直接调用 Cline API，则不要把这类请求误当成扩展登录。进入 app.cline.bot，打开 Settings > API Keys 创建密钥；每次请求都要把它放入 Authorization 请求头，并使用 Bearer 令牌格式：

Authorization: Bearer <你的 Cline API Key>

扩展和 CLI 登录时生成的账号令牌由系统自动管理，不需要手动复制。这条边界来自 Cline API Authentication 文档：Cline API 官方推荐 API Key 用于脚本、CI/CD 等程序化访问，扩展和 CLI 则使用登录后自动生成的账号令牌。

路径一：用 Cline 账号登录

Cline 官方目前把 Cline（usage-billing） 作为推荐入口。打开 Cline 面板，点击 Sign In，在弹出的授权页面选择 Google、GitHub 或邮箱完成登录，再返回编辑器。

这条路径适合没有 API 密钥，或者不想分别配置不同模型提供商账号的用户。按官方说明，它无需设置 API Key；需要注意的是，它并非完全离线，模型请求仍会发送到所选的云端模型服务。

完成后应看到两个明显变化：Cline 面板不再显示登录按钮，模型选择区域可以正常加载账户允许使用的模型。还可以新建一个最小任务，让 Cline 读取当前项目中的单个文件。若请求能进入读取文件流程，说明账号登录和模型调用均已连通，而不是只完成了浏览器授权。

路径二：使用 ClinePass

在 Cline 设置的 API Provider 下拉框中选择 ClinePass，点击 Sign In。如果页面提示订阅，按页面显示的套餐与付款提示完成订阅，再返回 Cline 面板。

这条路径与普通 Cline 账号登录不要混用：选择 ClinePass 后，界面应显示 ClinePass 的登录或订阅状态，而不是要求你把模型提供商密钥粘进 API Key 字段。官方将 ClinePass 单列为一种鉴权路径，因此配置成功后应看到 ClinePass 标识或与之对应的账户状态。

如果 Cline 面板一直要求填写普通供应商密钥，先重新检查 API Provider 是否已经切换为 ClinePass。这是按官方鉴权流程与字段定义作出的操作判断，不是额外报错。

路径三：用自己的 API 密钥

先在目标模型提供商的官方控制台创建密钥。回到 Cline 面板，点击齿轮图标，在 API Provider 中选择对应提供商，再把密钥粘贴到 API Key 字段。Cline 的 Authorizing with Cline 明确规定了这条顺序：先选提供商，再填密钥。

常见误区是只复制了前半段密钥，或误把账号登录后生成的令牌当成供应商 API Key。模型提供商控制台创建的密钥用于 API Key 输入框；Cline 自动生成的账号令牌只服务于扩展、CLI 和 Cline API 内部鉴权，不应互相替代。

填好后进行一次最小请求：让 Cline 列出当前目录文件或读取指定文件。鉴权通过后，Cline 会开始规划文件读取；若仍停留在登录页，应返回 Settings 检查提供商名称、密钥字段和粘贴内容，而不是反复新建对话。

路径四：连接 Ollama 或 LM Studio

在 Cline 的 API Provider 中选择 Ollama 或 LM Studio。本地运行模式不需要 API Key，但必须先启动对应的本地运行时，并确认端口与服务可用；随后在 Cline 中选择已安装的模型。

如果模型列表为空，优先检查本地服务是否真的在运行。按官方流程推断，本地服务未启动时，Cline 即使保存了提供商设置，也无法加载模型。成功标志是模型名称能被选中，并且发送最小任务后出现模型响应，而不是鉴权或连接失败。

登录状态错乱时怎么处理

Cline 官方仓库页面列出过三条明确的状态提示：

• You signed in with another tab or window. Reload to refresh your session.
• You signed out in another tab or window. Reload to refresh your session.
• You switched accounts on another tab or window. Reload to refresh your session.

这三句话的共同点是账号状态在另一个标签页或窗口发生了变化。对应处理不是重新粘贴 API Key，而是先重新加载当前 Cline 窗口，确认登录账号与当前账号一致；如果仍异常，再退出并重新点击 Sign In。如果使用 CLI，可重新执行登录流程，并确认 cline 使用的终端与浏览器授权发生在同一个账号下。

另一个常见误区是把本地模型当成云端密钥。Ollama 与 LM Studio 不需要 API Key；反过来，自带密钥模式也不能因为 Cline 账号已经登录，就省略 API Key 字段的填写。

确认鉴权真的已经生效

最可靠的确认方式不是看设置页有没有被保存，而是完成一次真实请求。在 Cline 中新建对话，选择已经配置的模型，然后执行一个低风险动作，例如读取当前目录中的 README 文件。

成功时应依次出现：模型名称已选中、请求没有停在登录或密钥页面、Cline 开始执行读取动作。最后一步进入文件读取流程，比单看“设置已保存”更能证明鉴权链路可用，因为登录状态、模型权限和实际 API 请求都会参与这次检查。

如果使用的是 Cline API 脚本，则检查请求是否包含：

Authorization: Bearer <你的 Cline API Key>

按官方认证页面的定义，请求缺少这个 Bearer 请求头就不能视为已完成鉴权。程序化访问的密钥可在 app.cline.bot 的 Settings > API Keys 管理；不要把该密钥提交到公开仓库或粘贴到日志中。

官方入口与问题反馈

产品入口与最新文档分别见 Cline 官方首页 和 Cline 官方文档。桌面版、扩展和 CLI 的发布记录集中在 Cline Releases，便于核对版本变化。

遇到无法复现的鉴权问题时，优先到 Cline GitHub Issues 搜索 authentication、API key、OAuth 或 ClinePass；使用方法讨论可进入 GitHub Discussions。提交问题时附上 Cline 版本、使用的 API Provider、桌面或 CLI 入口，以及去掉密钥后的完整报错，能减少来回确认成本。