需要理解的两个概念: 任务 - Cline 要完成的单个工作(“为 utils.js 添加测试”)。您描述所需内容,Cline 计划如何完成,然后执行该计划。任务在实例上运行。 实例 - 一个独立的 Cline 工作区。每个实例一次运行一个任务。创建多个实例以并行运行处理项目不同部分的多个任务。1. 交互模式:先计划,后执行
从这里开始了解 Cline 的工作方式。交互模式会打开一个聊天会话,您可以在执行前查看计划。
Cline 在当前目录中打开一个交互式会话。将您的任务作为消息键入。Cline 进入计划模式并提出分步策略。 在聊天中查看或编辑计划。准备就绪后,切换到执行:
Cline 执行批准的步骤——读取文件、编写代码、运行命令。您在整个过程中保持控制。
2. 无头单次运行:无需聊天完成任务
将其用于自动化,您希望有一行命令即可完成工作。
cline instance new --default
cline task new -y "Generate unit tests for all Go files"
使用 -y (YOLO) 标志,Cline 会自主规划和执行,无需交互式聊天。非常适合 CI、cron 作业或脚本。 示例:# Create a complete feature
cline task new -y "Create a REST API for user authentication"
# Generate documentation
cline task new -y "Add JSDoc comments to all functions in src/"
# Refactor code
cline task new -y "Convert all var declarations to const/let"
使用以下命令监控您的任务
# View task status
cline task view
# Follow task progress in real-time
cline task view --follow
按 Ctrl+C 退出视图。
在目录或干净的 Git 分支上谨慎使用 YOLO 模式。您以牺牲监督换取速度,因此如果需要,请准备好回滚。
3. 多实例:并行运行代理
多个实例允许您在同一项目上并行工作,而不会产生上下文冲突。同时运行前端、后端和基础设施任务。 创建您的第一个实例:
这将返回一个实例地址,您将使用它来定位任务。将任务附加到此实例
# Frontend work on first instance
cline task new -y "Build React components"
在一个命令中创建第二个实例并将其设置为默认值
cline instance new --default
现在您可以创建任务而无需指定地址——它们会自动使用默认实例
# Backend work on the new default instance
cline task new -y "Implement API endpoints"
列出所有正在运行的实例
完成后停止所有实例
跟踪 cline instance new 返回的实例地址。在编写多代理脚本时,存储这些 ID 并将您的任务导向相应的实例。
配置本地提供程序的上下文窗口
对于 Ollama 和 LM Studio,您可以通过 CLI 配置模型上下文窗口
# For Ollama
cline config s ollama-api-options-ctx-num=32768
# For LM Studio
cline config s lm-studio-max-tokens=32768
对于其他提供商(Anthropic、OpenRouter 等),上下文窗口在模型元数据中按模型定义,并且不可由用户配置——Cline 会自动使用每个模型的内置上下文限制。
选择合适的流程
- 交互模式:最适合探索新问题、了解 Cline 的工作方式,或者在执行前需要查看计划时使用
- 无头单次运行:非常适合自动化、CI/CD,以及您信任 Cline 无需监督即可执行的任务
- 多实例:当您需要并行化工作或为项目的不同部分维护单独上下文时使用
有关深入的命令和标志,请查看CLI 参考页面,获取所有可用选项的完整文档。
后续步骤