Documentation Index
Fetch the complete documentation index at: https://docs.megallm.io/llms.txt
Use this file to discover all available pages before exploring further.
Cline 是一个功能强大的 VSCode 扩展,结合了 AI 辅助、终端集成、自主任务执行和高级上下文感知。配置它以使用 MegaLLM 来访问多个 AI 模型。
快速配置
Anthropic 格式 (Claude)
OpenAI 格式 (GPT)
环境变量
配置 Claude 模型
打开 Cline 设置
- 按
Ctrl+Shift+P / Cmd+Shift+P
- 输入:
Cline: Open Settings
- 或:
设置 → 扩展 → Cline
选择 API 提供商
- API 提供商:选择
Anthropic
- 基础 URL:
https://ai.megallm.io
- API 密钥:
sk-mega-your-api-key-here
选择 Claude 模型
- 默认模型:
claude-sonnet-4
- 上下文窗口:
200000 令牌
- 温度:
0.5
启用功能
- 自动上下文检测
- 文件监视器
- 终端集成
- Git 集成
settings.json 中的配置:{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "sk-mega-your-api-key-here",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4",
"cline.contextWindow": 200000,
"cline.features": {
"autoContext": true,
"fileWatcher": true,
"terminalIntegration": true,
"gitIntegration": true
}
}
**注意:**对于 Anthropic 格式,baseURL 应为 https://ai.megallm.io(不带 /v1)
配置 GPT 模型
打开 Cline 设置
- 按
Ctrl+Shift+P / Cmd+Shift+P
- 输入:
Cline: Open Settings
选择 OpenAI 提供商
- API 提供商:选择
OpenAI
- 基础 URL:
https://ai.megallm.io/v1
- API 密钥:
sk-mega-your-api-key-here
选择 GPT 模型
- 默认模型:
gpt-5
- 上下文窗口:
128000 令牌
- 温度:
0.7
settings.json 中的配置:{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "sk-mega-your-api-key-here",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gpt-5",
"cline.contextWindow": 128000,
"cline.features": {
"autoContext": true,
"fileWatcher": true,
"terminalIntegration": true
}
}
**注意:**对于 OpenAI 格式,baseURL 应包含 /v1:https://ai.megallm.io/v1
安全配置
步骤 1:设置环境变量# 添加到 ~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
# 对于 Claude 模型
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
# 对于 GPT 模型
export OPENAI_BASE_URL="https://ai.megallm.io/v1"
步骤 2:重新加载 shellsource ~/.bashrc # 或 ~/.zshrc
步骤 3:在 settings.json 中引用{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "${env:ANTHROPIC_BASE_URL}"
},
"cline.defaultModel": "claude-sonnet-4"
}
API 密钥保持安全且不在版本控制中
场景示例
场景 1:首次安装
从零开始完成设置:
安装 Cline 扩展
- 打开 VSCode
- 转到扩展:
Ctrl+Shift+X / Cmd+Shift+X
- 搜索:
Cline
- 点击 安装
- 如果提示则重新加载 VSCode
获取 MegaLLM API 密钥
- 访问 MegaLLM 控制台
- 导航至 API 密钥 部分
- 点击 创建新密钥
- 复制密钥(以
sk-mega- 开头)
配置 Cline
打开命令面板并运行:Cline: Open Settings选择您偏好的格式:对于 Claude 模型:{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "sk-mega-your-actual-key",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4"
}
对于 GPT 模型:{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "sk-mega-your-actual-key",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gpt-5"
}
打开 Cline 面板
- 点击左侧边栏中的 Cline 图标
- 或:
Ctrl+Shift+P → Cline: Open
- 应该看到连接状态:✓ 已连接
测试配置
在 Cline 聊天中输入:你在使用什么模型?编写一个 Python 的 hello world 函数。
预期响应:我通过 MegaLLM 使用 claude-sonnet-4。
def hello_world():
print("Hello, World!")
if __name__ == "__main__":
hello_world()
场景 2:自主任务执行
使用 Cline 处理复杂的多步骤任务:
场景:“将身份验证模块重构为使用 JWT 令牌”
配置自主模式
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-opus-4-1-20250805",
"cline.autonomousMode": {
"enabled": true,
"requireApproval": "perFile",
"maxIterations": 10
},
"cline.features": {
"terminalIntegration": true,
"gitIntegration": true,
"fileWatcher": true
}
}
向 Cline 分配任务
打开 Cline 面板并提供详细说明:任务:将身份验证重构为使用 JWT
要求:
1. 安装 jsonwebtoken 包
2. 更新登录端点以生成 JWT
3. 创建中间件来验证 JWT
4. 更新受保护的路由
5. 为新的认证流程编写测试
6. 更新文档
当前认证在:src/auth/
Cline 自主执行
Cline 将:
- 分析当前认证代码
- 运行:
npm install jsonwebtoken
- 创建新的 JWT 工具
- 更新登录控制器
- 创建中间件
- 更新路由
- 生成测试
- 更新文档
您在每个文件更改写入之前进行批准 审查并提交
# Cline 可以执行 git 命令
git add .
git commit -m "重构:实现 JWT 身份验证"
**结果:**完整的身份验证重构,手动工作量最小!
场景 3:项目特定的 Cline 配置
不同的项目需要不同的 Cline 设置:
Python 数据分析项目:
.vscode/settings.json:
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-opus-4-1-20250805",
"cline.context": {
"language": "python",
"frameworks": ["pandas", "numpy", "matplotlib"],
"codeStyle": "pep8"
},
"cline.customPrompts": {
"analyze": "Analyze this data processing code for efficiency",
"visualize": "Suggest matplotlib visualization",
"optimize": "Optimize pandas operations for large datasets"
}
}
React/TypeScript Web 应用:
.vscode/settings.json:
{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gpt-5",
"cline.context": {
"language": "typescript",
"frameworks": ["react", "next.js", "tailwind"],
"codeStyle": "airbnb"
},
"cline.customPrompts": {
"component": "Create React component with TypeScript",
"api": "Generate API route with error handling",
"test": "Write React Testing Library tests"
}
}
Rust 系统项目:
.vscode/settings.json:
{
"cline.apiProvider": "openai",
"cline.openai": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1"
},
"cline.defaultModel": "gemini-2.5-pro",
"cline.context": {
"language": "rust",
"codeStyle": "rustfmt"
},
"cline.customPrompts": {
"review": "Review for memory safety and performance",
"unsafe": "Analyze unsafe block for correctness",
"optimize": "Suggest performance optimizations"
}
}
场景 4:终端集成工作流
使用 Cline 的终端功能处理 DevOps 任务:
配置:
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4",
"cline.features": {
"terminalIntegration": true,
"gitIntegration": true,
"fileWatcher": true
},
"cline.terminal": {
"autoExecute": false,
"requireApproval": true,
"allowedCommands": ["npm", "git", "docker", "kubectl"]
}
}
示例工作流:
您: "为这个 Node.js 应用设置 Docker 开发环境"
Cline: "我会帮您设置 Docker。我需要:
1. 创建 Dockerfile
2. 创建 docker-compose.yml
3. 添加 .dockerignore
4. 测试构建
我可以继续吗?"
您: "可以"
Cline 执行:
1. 创建包含 Node.js 18 的 Dockerfile
2. 创建包含应用 + postgres 的 docker-compose.yml
3. 添加 .dockerignore
4. 运行: docker-compose build
5. 运行: docker-compose up -d
6. 运行: docker-compose ps (验证)
结果: <Icon icon="check" /> Docker 环境运行中
场景 5:从 GitHub Copilot Chat 迁移
从 Copilot Chat 切换到 Cline 配合 MegaLLM:
为什么迁移:
- 可访问 Claude (更好的推理能力) 和 GPT
- 终端集成 (Copilot Chat 没有)
- 自主执行多步骤任务
- 更好的定价 (按使用付费 vs 按席位付费)
- 更强的上下文感知
迁移步骤:
禁用 Copilot Chat
{
"github.copilot.enable": false
}
安装 Cline
VSCode 扩展 → 搜索 “Cline” → 安装
使用 MegaLLM 配置
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4"
}
学习 Cline 命令
/explain - 解释选中的代码
/test - 生成测试
/fix - 调试和修复问题
/refactor - 重构代码
/task - 执行多步骤任务
比较体验
相比 Copilot Chat 的优势:
- 可以执行终端命令
- 更擅长多文件修改
- 使用 Claude Opus 处理复杂推理
- 可以运行测试并验证更改
- 内置 Git 集成
功能对比:
| 功能 | Copilot Chat | Cline + MegaLLM |
|---|
| 聊天界面 | | |
| 代码解释 | | 使用 Claude 更好 |
| 代码生成 | | |
| 终端执行 | | |
| 多文件编辑 | 有限 | 广泛 |
| 模型选择 | 仅 GPT-4 | GPT、Claude、Gemini |
| 自主任务 | | |
| Git 集成 | 基础 | 高级 |
| 定价 | $10-20/月 | 按使用付费 |
场景 6:多模型策略
根据任务复杂度切换模型:
配置:
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4",
"cline.modelProfiles": {
"fast": {
"provider": "openai",
"model": "gpt-4o-mini",
"description": "Quick tasks, simple completions"
},
"balanced": {
"provider": "anthropic",
"model": "claude-sonnet-4",
"description": "Most tasks, good balance"
},
"powerful": {
"provider": "anthropic",
"model": "claude-opus-4-1-20250805",
"description": "Complex reasoning, refactoring"
},
"creative": {
"provider": "openai",
"model": "gpt-5",
"description": "Documentation, naming"
}
}
}
使用模式:
上午: 快速修复 bug
→ 使用 "fast" 配置文件 (gpt-4o-mini)
→ 快速响应简单问题
中午: 功能开发
→ 使用 "balanced" 配置文件 (claude-sonnet-4)
→ 良好质量,合理速度
下午: 复杂重构
→ 使用 "powerful" 配置文件 (claude-opus-4)
→ 最佳架构推理能力
晚上: 编写文档
→ 使用 "creative" 配置文件 (gpt-5)
→ 引人入胜的文档和注释
切换配置文件:
- 在 Cline 面板中,点击模型名称
- 从下拉菜单选择配置文件
- 或使用命令:
/model powerful
场景 7:CI/CD 集成
在自动化工作流中使用 Cline:
GitHub Actions 示例:
.github/workflows/cline-review.yml:
name: Cline AI Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
ai-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup Node.js
uses: actions/setup-node@v3
with:
node-version: '18'
- name: Install Cline CLI
run: npm install -g @cline/cli
- name: Configure Cline
env:
MEGALLM_API_KEY: ${{ secrets.MEGALLM_API_KEY }}
run: |
mkdir -p ~/.vscode
cat > ~/.vscode/settings.json << EOF
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"apiKey": "$MEGALLM_API_KEY",
"baseURL": "https://ai.megallm.io"
},
"cline.defaultModel": "claude-sonnet-4"
}
EOF
- name: Run AI Review
run: |
cline review \
--files "$(git diff --name-only origin/main...HEAD)" \
--output review.md \
--model claude-sonnet-4
- name: Run Security Check
run: |
cline security-scan \
--files "$(git diff --name-only origin/main...HEAD)" \
--output security.md
- name: Post Review Comments
uses: actions/github-script@v6
with:
script: |
const fs = require('fs');
const review = fs.readFileSync('review.md', 'utf8');
const security = fs.readFileSync('security.md', 'utf8');
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: `## Cline AI Review\n\n${review}\n\n## Security Analysis\n\n${security}`
});
配置选项
完整参考
{
// API 提供商配置
"cline.apiProvider": "anthropic", // 或 "openai"
// Anthropic (Claude) 配置
"cline.anthropic": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io" // Anthropic 不需要 /v1
},
// OpenAI (GPT) 配置
"cline.openai": {
"apiKey": "${env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1" // OpenAI 需要包含 /v1
},
// 模型设置
"cline.defaultModel": "claude-sonnet-4",
"cline.contextWindow": 200000,
"cline.temperature": 0.5,
"cline.maxTokens": 4096,
// 功能
"cline.features": {
"autoContext": true,
"fileWatcher": true,
"terminalIntegration": true,
"gitIntegration": true,
"multiFileEdit": true
},
// 自主模式
"cline.autonomousMode": {
"enabled": true,
"requireApproval": "perFile", // "perFile", "perAction", "never"
"maxIterations": 10
},
// 终端设置
"cline.terminal": {
"autoExecute": false,
"requireApproval": true,
"allowedCommands": ["npm", "git", "docker"],
"blockedCommands": ["rm -rf", "sudo"]
},
// 上下文设置
"cline.context": {
"language": "typescript",
"frameworks": ["react", "next.js"],
"codeStyle": "airbnb",
"maxContextFiles": 20,
"includeGitInfo": true
},
// 自定义提示
"cline.customPrompts": {
"explain": "详细解释此代码",
"test": "生成全面的测试",
"review": "审查错误和改进",
"refactor": "重构以提高可维护性",
"doc": "生成详细文档"
},
// UI 设置
"cline.ui": {
"theme": "auto",
"position": "sidebar", // "sidebar", "panel", "editor"
"showStatusBar": true,
"showInlineHints": true
}
}
模型选择指南
| 任务 | 推荐模型 | API 提供商 | 原因 |
|---|
| 代码审查 | claude-sonnet-4 | Anthropic | 出色的分析能力 |
| 重构 | claude-opus-4-1-20250805 | Anthropic | 最佳推理能力 |
| 快速任务 | gpt-4o-mini | OpenAI | 最快 |
| Web 开发 | gpt-5 | OpenAI | 适合 JS/React |
| 文档编写 | gpt-5 | OpenAI | 清晰的写作 |
| 系统代码 | gemini-2.5-pro | OpenAI | 精确的逻辑 |
| 自主任务 | claude-opus-4-1-20250805 | Anthropic | 复杂推理 |
测试 1:基本聊天
- 在 VSCode 中打开 Cline 面板
- 开始新会话
- 输入:
你在使用什么模型?
- 应响应模型名称和 MegaLLM 确认
测试 2:代码解释
- 在代码中选择一个函数
- 在 Cline 中:
/explain
- 应提供详细解释
测试 3:终端集成
- 在 Cline 中:
列出当前目录中的所有文件
- Cline 应建议:
ls -la
- 批准执行
- 应看到文件列表
测试 4:多文件任务
- 请求:
为所有 API 路由添加错误处理
- Cline 分析多个文件
- 显示每个文件的建议更改
- 批准并应用
测试 5:状态检查
运行命令:/status
应显示:
✓ 已连接到 MegaLLM
✓ 模型: claude-sonnet-4
✓ 上下文: 可用 200k 令牌
✓ 终端: 已启用
✓ Git: 已启用
故障排除
症状:
- 已发送消息但无响应
- “模型初始化失败” 错误
- 连接超时
解决方案:
-
检查 API 提供商配置:
// 对于 Claude 模型
{
"cline.apiProvider": "anthropic",
"cline.anthropic": {
"baseURL": "https://ai.megallm.io" // 不需要 /v1
}
}
// 对于 GPT 模型
{
"cline.apiProvider": "openai",
"cline.openai": {
"baseURL": "https://ai.megallm.io/v1" // 需要包含 /v1
}
}
-
验证模型是否可用:
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
https://ai.megallm.io/v1/models | jq '.data[].id'
-
检查模型名称是否正确:
claude-sonnet-4
claude-sonnet-3 (旧版本)
gpt-5
gpt-5.0 (错误格式)
-
重置 Cline:
- 命令面板:
Cline: Reset Configuration
- 重启 VSCode
- 从头重新配置
症状:
- Cline 建议命令但不执行
- “终端集成已禁用” 消息
解决方案:
-
启用终端集成:
{
"cline.features": {
"terminalIntegration": true
}
}
-
检查终端权限:
- VSCode 设置 → 搜索 “terminal allow”
- 启用:
Terminal > Integrated: Allow Workspace Configuration
-
验证允许的命令:
{
"cline.terminal": {
"autoExecute": false,
"requireApproval": true,
"allowedCommands": ["npm", "git", "docker"]
}
}
-
手动测试:
- 打开 VSCode 终端
- 尝试直接运行命令
- 确保终端在使用 Cline 之前正常工作
症状:
- “上下文过大” 错误
- Cline 无法包含所有文件
解决方案:
-
减少上下文窗口:
{
"cline.contextWindow": 100000 // 从 200000 减少
}
-
限制包含的文件:
{
"cline.context": {
"maxContextFiles": 10 // 从 20 减少
}
}
-
更具体:
而不是:“审查整个项目”
改为:“仅审查认证模块”
-
使用较小的模型:
{
"cline.defaultModel": "gpt-4o-mini" // 较小的上下文
}
症状:
- Cline 不断迭代但无进展
- 任务从不完成
- 相同错误重复出现
解决方案:
-
限制最大迭代次数:
{
"cline.autonomousMode": {
"maxIterations": 5 // 从 10 减少
}
}
-
需要更多批准:
{
"cline.autonomousMode": {
"requireApproval": "perAction" // 而不是 "perFile"
}
}
-
停止并重启:
- 点击 Cline 面板中的”停止”按钮
- 审查 Cline 尝试的内容
- 提供更具体的说明
-
分解任务:
而不是:“重构整个身份验证系统”
尝试:“首先,只更新登录端点以使用 JWT”
症状:
- “无效的 API 密钥” 错误
- 401 未授权
- 连接被拒绝
解决方案:
-
验证环境中的密钥:
echo $MEGALLM_API_KEY
# 应输出: sk-mega-...
-
重新加载 VSCode:
- 关闭所有 VSCode 窗口
- 重新加载 shell:
source ~/.bashrc
- 重新打开 VSCode
-
直接设置密钥(测试用):
{
"cline.anthropic": {
"apiKey": "sk-mega-your-actual-key" // 暂时用于测试
}
}
-
手动测试密钥:
curl -X POST https://ai.megallm.io/v1/chat/completions \
-H "Authorization: Bearer $MEGALLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hi"}]}'
-
检查密钥是否激活:
症状:解决方案:
-
禁用冲突的扩展:
{
"github.copilot.enable": false,
"tabnine.disable": true,
"aws.codeWhisperer.enabled": false,
"kilocode.enable": false
}
-
检查键绑定冲突:
- 文件 → 首选项 → 键盘快捷键
- 搜索 Cline 命令
- 解决任何冲突
-
一次尝试一个扩展:
- 禁用所有 AI 扩展
- 仅启用 Cline
- 测试功能
- 逐个重新启用其他扩展
最佳实践
使用环境变量
将 API 密钥保存在环境变量中:${env:MEGALLM_API_KEY}
项目特定配置
在 .vscode/settings.json 中为每个项目使用不同的模型
Git 集成
让 Cline 为您处理 git 操作
高级技巧
自定义斜杠命令
为常见任务创建快捷方式:
{
"cline.customCommands": {
"/deploy": "构建应用、运行测试并部署到暂存环境",
"/review-pr": "审查此 PR 中所有更改的文件以查找错误和改进",
"/setup-test": "设置测试文件结构并编写初始测试",
"/doc-api": "从代码注释生成 API 文档"
}
}
用法:在 Cline 聊天中输入 /deploy
上下文感知
改进 Cline 的理解:
{
"cline.context": {
"projectType": "microservices",
"architecture": "event-driven",
"databases": ["postgresql", "redis"],
"testingFramework": "jest",
"cicd": "github-actions"
}
}
Git 集成
让 Cline 管理 git 工作流:
{
"cline.git": {
"autoCommit": false,
"commitMessageStyle": "conventional",
"autoCreateBranches": true,
"branchPrefix": "cline/"
}
}
下一步
Kilocode 设置
配置 Kilocode 进行代码补全
RooCode 设置
配置 RooCode 独立应用