Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

快速上手：安装、授权与第一个任务

安装 Cline（桌面应用、IDE 扩展、CLI、Kanban、SDK），授权并选模型，在 IDE 里完成第一个任务：Plan/Act、批准改动、迭代与检查点。

选择安装方式

  • 桌面应用：把 Cline 作为原生应用，有专门的工作区来运行和管理智能体会话。
  • IDE 扩展：VS Code、Cursor、JetBrains、Windsurf、VSCodium、Antigravity。
  • CLI：终端工作流。
  • Kanban（预览）：用看板管理多个智能体。
  • SDK：用 @cline/sdk 构建你自己的应用。

桌面应用

从 cline.bot/desktop 下载你平台的安装包（macOS 和 Windows，Windows 目前是 beta）。选择提供商和开放权重模型（Cline Desktop 是面向开放权重模型的开源应用，所以模型访问由你自带），然后开始会话：可以并行运行会话、安排定时任务，并导入其他编码智能体的会话继续在 Cline 里做。远程机器见官方的 Cline Desktop SSH 页。

IDE 扩展

VS Code / Cursor / Windsurf / VSCodium / Antigravity：按 Ctrl/Cmd + Shift + X 打开扩展，搜索 Cline，点 Install，在扩展侧边栏找到 Cline，再在 Cline 设置里完成提供商设置（Windsurf 和 VSCodium 使用 Open VSX，流程相同）。

JetBrains：Settings → Plugins → Marketplace，搜索 Cline，点 Install 并重启 IDE，通过 View → Tool Windows → Cline 打开。

CLI

安装 Node.js 20+（推荐 22），然后：

npm install -g cline
cline auth        # 认证
cline             # 交互模式
cline "your task" # 直接运行一个任务

Kanban 与 SDK

Kanban：安装 Node.js 18+，运行 npx kanban。SDK：mkdir my-agent && cd my-agent && npm init -y && npm install @cline/sdk，然后从官方的 SDK 示例开始。

授权与选模型

Cline 通过提供商连接 AI 模型，有三条常见路径：Cline（用量计费）（推荐）用 Google/GitHub/邮箱登录，无需 API key；ClinePass 是月度订阅；**自带密钥（BYOK）**用你自己的提供商凭据（云端或本地运行时）。详见「模型与计费」。

IDE 里：点 Cline 面板里的设置图标（⚙️），在 API Provider 下拉框选提供商并认证（Cline 点 Sign In 完成 OAuth；BYOK 粘贴 API key；Ollama/LM Studio 这类本地运行时不需要密钥但要确保运行时在跑），再选模型。CLI 里运行 cline auth（简写 cline a），也可以一条命令配置：

cline auth --provider anthropic --apikey sk-... --modelid <模型名>

CLI 也会读取 ANTHROPIC_API_KEY、OPENAI_API_KEY 等环境变量。

常见认证问题：「Unauthorized: Please sign in」是会话过期，点 Sign In 重新认证；浏览器没打开时检查默认浏览器设置，或从 Cline 输出面板手动复制 URL；频繁重新认证时检查组织安全策略并确认没有清除 IDE 的密钥存储；无法访问组织时，在 app.cline.bot 确认成员身份并重新登录。

在 IDE 里完成第一个任务

以做一个待办应用为例：

  1. 打开项目文件夹：Cline 需要工作区，也就是一个它能创建和编辑文件的文件夹。VS Code/Cursor/Windsurf 里用 File → Open Folder，JetBrains 里用 File → Open；没有打开文件夹的话，Cline 不知道在哪里创建文件。
  2. 打开 Cline 面板：在活动栏找到 Cline 图标（小机器人）点击；找不到时，用命令面板运行 Cline: Open In New Tab，它还给你更大的屏幕空间。面板里有底部的输入框、上方的聊天区和右上角的设置齿轮。建议把 Cline 移到右侧边栏（拖动 Cline 图标到右侧面板），这样左边的项目文件一直可见，能看着工作区随 Cline 工作而变化（JetBrains 默认就在右侧）。
  3. 给 Cline 一个任务：在输入框里粘贴并回车，例如「Build a todo app in a single HTML file」，要求有添加任务的输入框、显示所有任务的列表、带删除线的完成复选框、删除按钮、简洁现代的 CSS，以及内联的 JavaScript。
  4. 理解 Plan 与 Act 模式：面板底部有 Plan / Act 切换。Plan 模式下 Cline 只说话，分析需求、讨论方案，不创建或修改任何文件，适合想先讨论做法的复杂任务；准备好让它写代码时，点切换按钮改到 Act。Act 模式下 Cline 立刻开始创建文件和写代码（但仍然在改动前请求你的批准）。
  5. 批准改动：Cline 在创建或编辑任何文件之前，会准确展示它想做什么并等你批准：聊天里显示文件路径和要写的代码（新增行用绿色高亮），下方有 Approve 和 Reject 两个按钮。点 Approve 让它写入文件。每次文件创建、文件编辑和终端命令都需要你的明确批准；用惯之后可以启用自动批准，对特定动作跳过确认。
  6. 查看创建的应用：macOS 在终端运行 open index.html，Windows 用 start index.html，Linux 用 xdg-open index.html；也可以在文件资源管理器里右键 index.html 选在 Finder/文件管理器中显示后双击打开，或用 VS Code 的 Live Server 扩展。
  7. 在同一个对话里迭代：Cline 记得整个对话，所以你可以要求修改，它会改现有代码而不是重来，例如「Add local storage so tasks persist when I refresh the page」「Switch to a dark theme with purple accent colors」「Add a filter to show all, active, or completed tasks」。每次它会读取当前文件、以 diff（绿色新增、红色删除）提出具体改动并等你批准。
  8. 用检查点撤销错误：Cline 在每次改动后自动保存一个检查点。滚动对话，在做了改动的每一步旁边有两个按钮：Compare（查看该步骤改了哪些文件的前后 diff）和 Restore（把项目回滚到那个时点）。Restore 有三个选项：Restore Task and Workspace（文件和对话都重置到该点，想彻底重来时用）、Restore Task Only（保留当前文件但回退对话上下文，很少需要）、Restore Workspace Only（文件重置到该点但保留完整对话，想换个做法又保留对话历史时用，推荐新手用这个）。检查点与 Git 是分开的，不影响你的提交、分支或任何版本控制。

之后你可以在对话里输入 /newtask 开始新对话，用 /reportbug 反馈问题。接下来看使用了解日常工作流，看定制了解规则、技能、MCP 和钩子。