Cline (VSCode) 接入教程 - XiDao Api 文档

什么是 Cline?

Cline（原名 Claude Dev）是一个完全开源免费的 VS Code AI 编程助手。它可以自主读写文件、运行终端命令、搜索网页，是目前最活跃的 VS Code AI 插件之一。

提示: Cline 完全开源免费（MIT 许可证），支持自定义 OpenAI 兼容 API 端点，可无缝接入 XiDao Api。

🆓

完全免费开源

MIT 开源许可证，无任何限制，可自由使用和修改

📝

文件操作

自主读写文件，创建、编辑、删除代码文件

⚡

终端执行

直接运行终端命令，安装依赖、运行测试、执行脚本

🔍

智能搜索

自动搜索文档和网页，获取最新信息辅助编程

安装 Cline

方式一：从 VS Code 扩展商店安装（推荐）

1

打开扩展面板

在 VS Code 中按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展面板

2

搜索 Cline

在搜索框中输入 "Cline"，找到由 cline 发布的扩展（注意区分其他类似名称的扩展）

3

点击安装

点击「Install」按钮完成安装

方式二：命令行安装

bash

# 通过 VS Code 命令行安装
code --install-extension cline.cline

# 验证安装
code --list-extensions | grep cline

成功! 安装完成后，VS Code 侧边栏会出现 Cline 图标。

配置 API

1. 打开设置界面

安装完成后，点击侧边栏的 Cline 图标打开主界面：

2. 选择 API 提供商

在 API Provider 下拉菜单中选择：
OpenAI Compatible 或 Custom (OpenAI Compatible)

3. 输入 Base URL

text

# 国内用户
https://api.xidao.online/v1

# 全球加速用户
https://global.xidao.online/v1

4. 输入 API Key

在 API Key 输入框中粘贴你的 XiDao Api Key（格式为 sk-xxxxxxxx）

获取 API Key：登录 https://api.xidao.online → 令牌管理 → 复制令牌

5. 选择模型

在 Model 下拉菜单中选择你想使用的模型：

text

# 推荐选项
claude-sonnet-4-20250514   # Claude Sonnet 4.5（性价比高）
gpt-5.1                     # GPT-5.1（通用性强）
claude-opus-4-20250514     # Claude Opus 4（最强能力）

6. 保存配置

点击 Save 保存配置，Cline 会自动验证连接是否成功。

注意: 如果连接失败，请检查 API Key 是否正确、Base URL 是否包含 /v1 后缀、网络是否通畅。

使用方法

开始对话

配置完成后，可以直接在输入框中输入指令与 Cline 对话：

模式	说明	示例
💬 Ask	简单问答，不修改文件	"解释这个函数的作用"
✨ Code	生成/修改代码	"帮我写一个用户登录接口"
🔧 Edit	编辑指定文件	"修复 utils.js 中的 bug"
⚡ Terminal	执行终端命令	"运行测试并修复失败的用例"

快捷键

text

Ctrl/Cmd + L          打开/聚焦 Cline 面板
Ctrl/Cmd + I          在光标位置插入 Cline
Escape               停止当前响应
Enter                发送消息（Shift+Enter 换行）

上下文感知

Cline 会自动理解你的项目上下文：

自动读取你打开的文件内容
理解项目结构和依赖关系
@提及特定文件或代码片段作为上下文
#引用错误信息让 Cline 修复

核心功能

📝 自动代码编辑

Cline 可以直接在你的项目中创建、修改、删除文件，无需手动复制粘贴。

⚡ 终端集成

可以执行任意终端命令，包括：

安装依赖（npm install, pip install）
运行测试并分析结果
Git 操作（提交、分支等）
构建项目

🌐 浏览器工具

内置 MCP 浏览器工具，可以：

搜索网页获取最新信息
阅读在线文档
调试 Web 应用

🔌 MCP 支持

支持 MCP (Model Context Protocol) 服务器，可以连接外部工具和数据源。

使用技巧

💡 技巧 1：明确任务范围

给 Cline 明确的任务边界，例如："只修改 src/components 目录下的文件，不要改动配置文件"

💡 技巧 2：分步骤执行复杂任务

对于复杂任务，建议分步进行："先分析现有代码结构，然后提出重构方案，最后逐步实施"

💡 技巧 3：善用 @ 和 # 符号

@filename - 引用特定文件作为上下文
#error - 引用错误信息让 Cline 分析

💡 技巧 4：选择合适的模型

日常开发推荐 Claude Sonnet 4.5，复杂推理任务使用 Claude Opus 4，简单任务可用 Gemini Flash 节省成本。

常见问题排查

❌ 连接失败

确认 Base URL 正确（必须包含 /v1 后缀）
确认 API Key 有效且未过期
尝试切换国内/全球节点
检查 VS Code 网络代理设置

⚠️ 响应慢

切换到更快的模型（如 Gemini Flash）
减少对话上下文长度
关闭不必要的文件标签页

❌ 权限被拒

Cline 执行操作前会请求权限确认。如果误点了拒绝，可以在对话框中重新允许。

提示: 更多帮助请访问 Cline 官方文档：docs.cline.ai