01WHAT IT SOLVES
这个项目解决什么问题？
cline 的定位不是单一的代码补全工具，而是以共享智能体核心为基础的多形态编程代理，官方提供 VS Code 扩展、CLI、桌面应用和 SDK，JetBrains 插件则暂未开源。它通过规划与执行模式理解代码库，结合文件编辑、终端命令、浏览器和 MCP 工具完成跨文件任务，并强调差异审查、检查点和人工批准。在同类方案中，它更接近可嵌入开发流程的代理平台：既可作为 IDE 助手直接使用，也可作为 CLI 接入 CI/CD，或通过 SDK 构建具备插件、连接器、定时任务和多智能体协作能力的集成产品。
02CORE CAPABILITIES
核心能力
多形态接入
提供 VS Code 扩展、CLI、macOS 与 Windows 桌面应用以及 Node.js SDK，覆盖交互式开发、脚本化和集成场景。
项目级代码修改
读取项目结构与文件关系，协调修改多个文件，并跟踪差异、检查点和执行记录，便于审查与撤销。
工具执行与审批
可执行终端命令、运行构建和测试、访问网页及外部工具；支持规划与执行模式，并可由用户逐项审批。
多模型与扩展机制
支持多家云端模型、OpenAI 兼容接口及 Ollama、LM Studio 等本地模型，并可通过插件、生命周期钩子和 MCP 扩展能力。
03适合谁
- 希望在 IDE 或终端中使用编程智能体协助修改代码的开发者
- 需要将代理接入内部工具、自动化脚本或 CI/CD 的工程团队
- 希望切换云端与本地模型、评估不同提供商的团队
- 需要插件、MCP、外部系统连接或多智能体协作能力的开发者
04典型使用场景
- 在编辑器中分析代码库、修复类型或语法错误并生成跨文件变更
- 通过 CLI 无交互运行代理，将结果接入脚本或 CI/CD 流程
- 使用 SDK 构建带自定义工具、连接器、审计策略或多智能体团队的内部代理
- 使用定时任务生成日报、依赖检查和代码库健康报告
05为什么值得关注
- 同一套智能体核心覆盖 IDE、CLI、桌面端和 SDK，产品形态较为完整
- 同时支持人工审批和自主执行，适用场景从交互开发延伸到自动化
- 模型提供商覆盖云端、兼容接口和本地部署，便于按工作流选择
- 插件、MCP、连接器和多智能体团队使其具备二次开发价值
06采用前要注意
- JetBrains 插件当前未开源，README 未提供其源码位置
- 使用代理执行命令、编辑文件和连接外部系统时，需要自行控制权限与数据边界
- 功能和模型行为依赖所接入的模型服务，模型输出质量与可用性无法由项目单独保证
- SDK、CLI、桌面应用等版本分别迭代，采用时需分别关注各自变更记录
07RELEASE INTELLIGENCE
近期版本变化
cline v4.1.26：云端任务与模型路由更新
本次更新加入云端任务模型选择、云沙箱启动进度和模型目录调整，并修复 GPT-6、Gemini、Plan/Act 切换及工具调用等问题。使用云端会话、依赖默认模型或使用相关模型接口的开发者需要关注；未固定模型的提供商可能获得新的默认模型。
- 云端任务可单独选择模型，沙箱启动过程会显示仓库、分支和步骤进度
- 模型请求最多重试 3 次，GPT-6 与 Gemini 相关兼容性问题得到修复
- Kimi K3 的高推理等级改用 max 设置，模型目录新增并移除多个提供商
- Plan/Act 切换、规则禁用、空命令和问答交互等行为得到修正
cline desktop-v0.0.49：变更审阅与本地模型管理增强
桌面应用新增会话变更面板、项目文件树和集成终端，并完善本地模型设置、快捷键配置及 Hub 故障诊断。桌面端重度用户和希望通过本地模型工作的开发者可重点关注；若使用本地或 SSH 环境，也需留意文件查看与任务附着行为变化。
- 会话变更面板可查看单轮或整场会话修改的文件、行数与差异
- 项目文件面板支持只读浏览、Git 状态标记和文件与差异切换
- 新增 Ollama 与 LM Studio 模型管理页面，可查看模型信息、存储和内存占用
- Hub 启动失败时提供重试与诊断导出，并允许在设置中重启 Hub
cline cli-v3.0.74：运行任务附着与插件资源修复
CLI 更新改善了跨客户端任务附着、Hub 健康检查、模型重试和插件命令执行，同时修复 Gemini 工具调用及空命令处理等问题。用于无人值守脚本和持续集成的开发者需要关注；依赖模型目录默认值或插件二进制的项目也应核对变更。
- 打开已在其他 Cline 客户端运行的任务时会附着现有运行，而非重复启动
- Hub 状态检查和诊断命令加入 3 秒超时，避免异常时持续卡住
- 编译后的 CLI 可直接从二进制加载插件资源和仪表板
- Gemini、上下文压缩、问答工具和 PowerShell 命令处理得到修复
cline sdk/sdk/v0.2.0：会话恢复与运行时稳定性改进
SDK 本次更新改进了运行中会话的重新连接、能力请求路由、模型重试和上下文压缩，并优化检查点读取与 SSH 远程连接。构建多客户端或多智能体集成的团队值得重点关注；涉及长连接、代理转发或远程工作区的应用需验证新行为。
- 已有运行任务时会重新连接现有会话，不再替换其运行时
- Hub 会记录会话能力客户端，并在无可用客户端时快速返回错误
- 未知上下文上限的模型不再自动压缩，检查点读取减少 Git 进程数量
- ProxyJump SSH 连接获得更长超时，并改进了隧道与上传错误报告
cline desktop-v0.0.48：修复 GPT-6 模型请求兼容性
桌面端修复 GPT-6 模型在 OpenAI 与 Azure 兼容端点被拒绝的问题，同时恢复 Cline 提供商的默认模型并刷新模型目录。使用 GPT-6、Azure OpenAI 兼容接口或桌面端模型设置的开发者值得优先验证；其他用户主要受到默认模型变化影响。
- GPT-6 系列模型可正常调用 OpenAI 与 Azure OpenAI 兼容端点
- 请求令牌参数由 max_tokens 调整为 max_completion_tokens
- Cline 提供商默认模型恢复为 Claude Sonnet 5.5
- 模型目录新增 CommandCode 与 Reflection，并更新多个提供商默认模型
Cline cli-v3.0.73：修复 GPT 模型请求并更新目录
CLI 修复 GPT-6 等模型在 OpenAI 与 Azure OpenAI 兼容端点上因请求参数不匹配而失败的问题。未选择模型时，Cline 提供方改用 Claude Sonnet 5.5；模型目录也得到刷新。使用兼容端点或依赖默认模型的用户需要关注此次调整。
- GPT-6 模型改用兼容 OpenAI 与 Azure 的请求参数
- 未指定模型时默认使用 Claude Sonnet 5.5
- 模型目录新增提供方并更新多个服务商的默认模型
cline sdk/sdk/v0.0.95：GPT-6 兼容与模型目录更新
SDK 本次更新调整 GPT-6 模型的 OpenAI 兼容请求参数，记录 Hub 启动客户端身份，并刷新模型目录与多家提供商的默认模型。使用 GPT-6、OpenTelemetry 或依赖默认模型的集成需要关注；未固定模型的调用可能切换到新的默认配置。
- GPT-6 系列改用 max_completion_tokens，改善 OpenAI 与 Azure 兼容表现
- Hub 启动来源以 OpenTelemetry 资源属性发布，共享包新增身份读写接口
- 模型目录由 6952 项增至 7041 项，并新增 CommandCode 与 Reflection 提供商
- 多个提供商的默认模型被调整，OpenCode Go 的基础地址得到固定
Cline desktop-v0.0.47：修复桌面端插件加载并默认 Gemini 4 Argon
Desktop v0.0.47 修复了 0.0.46 因打包未包含 @cline/sdk 导致 goal 等市场插件报 Cannot find module 而无法加载的问题。移除了设置中的 Cloud sessions 独立开关，云会话在可用地区直接启用；流式错误重试 3 次；cline 提供商默认切换到 Gemini 4 Argon。模型目录同步刷新，新增 Boundless、Standard Compute，SambaNova 默认改为 MiniMax M3。影响桌面端用户和依赖市场插件的开发者，使用前最好确认插件与 SDK 版本匹配。
- 修复桌面端因打包缺包导致市场插件加载失败
- 移除 Cloud sessions 设置开关，自动按地区启用
- 流式错误重试 3 次并默认切换到 Gemini 4 Argon
- 模型目录同步刷新，SambaNova 入目录默认 MiniMax M3
Cline v4.1.25：新增云端会话并修复长请求超时
该版本开始逐步开放 Cline Cloud，可让任务在所选 GitHub 仓库与分支的托管沙箱中运行，并在关闭编辑器后继续执行。更新还修复本地模型长请求静默超时、兼容地址被自动追加路径、问题附件丢失及流式响应中断等问题，同时调整推荐模型和多家提供方的默认配置。
- Cloud 任务可在托管沙箱中运行，并显示于最近与历史记录
- 本地模型处理大型提示时不再因五分钟静默而直接失败
- 修复附件未传入模型、流式响应中断重试及兼容地址处理问题
- 依赖未固定模型的用户需注意推荐列表和默认模型变化
Cline cli-v3.0.72：CLI 强化无头自动化与 hub 调试输出
CLI v3.0.72 将插件运行收紧为 worker 模式并在配置和会话启动处给出明确提示，移除 in_process 兼容；流式错误重试 3 次并在失败日志携带 provider request id。cline hub ensure / cline hub start 新增 --json、--allow-port-fallback、--no-connectors、--login-shell-path，cline hub 支持 --discovery-path；hub 命令不再计入 CLI 激活统计。cline 提供商默认改为 Gemini 4 Argon，模型目录同步刷新。影响在 CI/
- 插件运行收紧为 worker，配置命令显式报告插件不可用
- cline hub 子命令新增 --json 与端口回退等调试参数
- 流式错误重试 3 次并附带 provider request id 日志
- 模型目录刷新并把 cline 默认改为 Gemini 4 Argon