Cline AI 编程助手教程

Cline 是 VS Code 上最强大的开源 AI 编程助手，支持自动创建文件、执行命令和代码重构。本文详解安装、配置、模型选择和使用技巧。

什么是 Cline？

Cline（原 Claude Dev）是一款 VS Code AI 编程插件，具备 Agent 能力：

• 自主编程：根据你的描述自动创建和修改代码文件
• 终端操作：自动执行 Shell 命令、运行测试
• 代码理解：分析整个代码库结构和逻辑
• 浏览器预览：可启动开发服务器并预览效果
• 完全开源：MIT 许可证，免费使用

安装

1. 打开 VS Code
2. 进入扩展市场（Ctrl+Shift+X）
3. 搜索 "Cline"
4. 点击 Install 安装
5. 安装后侧边栏出现 Cline 图标

配置 API Provider

Cline 本身免费，但需要配置 AI 模型 API。支持多种提供者：

方式一：OpenAI Compatible（推荐）

使用 OpenAI 兼容接口，可接入中转服务使用所有模型：

# Cline 设置
API Provider: OpenAI Compatible
Base URL: https://claude4u.com/v1
API Key: your-relay-key
Model ID: claude-sonnet-4-20250514

方式二：Anthropic API

API Provider: Anthropic
API Key: your-anthropic-key

方式三：OpenAI API

API Provider: OpenAI
API Key: your-openai-key

模型选择建议

• Claude Sonnet 4：编程能力最强，推荐作为默认模型
• Claude Opus 4：最强推理，适合复杂架构设计
• Gemini 2.5 Pro：超长上下文（100 万 token），适合大型代码库
• GPT-4o：通用能力均衡，响应速度快
• Gemini 2.5 Flash：最具性价比，适合简单任务

使用技巧

清晰的 Prompt

好的 Prompt 能显著提升 Cline 的输出质量：

# 差的 Prompt
"加个登录功能"

# 好的 Prompt
"在 src/pages/ 目录下创建一个登录页面组件 Login.tsx，使用 React Hook Form 处理表单，
包含邮箱和密码字段，调用 /api/auth/login 接口进行验证，
登录成功后跳转到 /dashboard。使用项目现有的 Tailwind CSS 样式。"

使用 @ 引用上下文

• @file：引用特定文件作为上下文
• @folder：引用整个目录
• @url：引用网页内容
• @problems：引用 VS Code 的问题面板

自定义指令

在项目根目录创建 .clinerules 文件，定义全局行为规则：

# .clinerules 示例
- 使用 TypeScript，不使用 any 类型
- 组件使用函数式写法和 React Hooks
- 样式使用 Tailwind CSS
- 每个函数添加 JSDoc 注释
- 错误处理使用 try-catch

审批与自动操作

Cline 默认需要你确认每步操作（文件修改、命令执行）。你可以在设置中调整：

• Ask：每步都需确认（最安全）
• Auto-approve reads：读取操作自动批准
• Auto-approve all：全部自动批准（最快但需信任模型）

常见问题

Cline 响应很慢

• 检查网络连接和 API 端点是否可达
• 尝试切换到更快的模型（如 Gemini 2.5 Flash）
• 减少上下文中引用的文件数量

Cline 修改了不该改的文件

• 在 .clinerules 中明确限制操作范围
• 使用 Ask 模式，逐步审批修改
• 利用 git 随时回退不满意的改动