> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline AI编程助手配置指南

> Cline插件配置老张API教程，VS Code中使用Claude、GPT等AI编程助手

## 插件简介

Cline（原 Claude Dev）是一款强大的 VS Code AI 编程助手插件，支持多种 AI 模型。通过 老张API，您可以灵活切换使用各种主流 AI 模型辅助编程。

## 快速安装

### 1. 安装插件

在 VS Code 扩展商店搜索 "Cline" 并安装

### 2. 配置 老张API

1. 点击左侧的 Cline 图标
2. 点击设置按钮（齿轮图标）
3. 选择 **OpenAI Compatible**
4. 配置参数：
   * **Base URL**：`https://api2.laozhang.ai/v1`
   * **API Key**：您的 老张API 密钥
   * **Model Name**：输入模型名称

### 推荐模型

#### 🎯 编程开发首选

* `claude-sonnet-4-6` ⭐（Claude Sonnet 4.6，编程能力强）
* `o4-mini`（OpenAI 推理模型，编程任务首选）
* `gemini-2.5-pro` ⭐（2M 上下文，多模态能力强）
* `deepseek-coder`（代码专精模型，128K 上下文）

#### 💡 复杂推理任务

* `o3` ⭐（最新推理模型，已大幅降价）
* `claude-sonnet-4-6-thinking`（Claude Sonnet 4.6 思维链模式）
* `deepseek-r1` ⭐（最新推理模型，64K 上下文）
* `grok-3-mini`（带推理能力的轻量模型）

#### 🚀 快速响应

* `gpt-4.1-mini`（轻量通用模型，成本较低）
* `gemini-2.5-flash` ⭐（速度快，成本低，1M 上下文）
* `claude-haiku-4-5`（轻量快速版本，200K 上下文）
* `gpt-4o-mini`（轻量快速版本，128K 上下文）

#### 💰 成本可控

* `deepseek-chat`（128K 上下文，综合能力强）
* `qwen-turbo`（阿里通义千问快速版）
* `gpt-4.1-nano`（轻量成本版本，128K 上下文）

## 核心功能

### 智能代码补全

```python theme={null}
# 输入注释，AI 自动生成代码
# 计算斐波那契数列的第 n 项
def fibonacci(n):
    # Cline 会自动补全实现
```

### 代码解释

选中代码片段，使用：

* `Cline: Explain Code`：解释代码
* `Cline: Explain Error`：解释错误

### 代码重构

* **优化性能**：提供性能优化建议
* **改进可读性**：重构复杂代码
* **修复问题**：自动修复常见问题

### 生成测试

```javascript theme={null}
// 原始函数
function add(a, b) {
    return a + b;
}

// Cline 生成的测试
describe('add function', () => {
    test('should add two numbers correctly', () => {
        expect(add(2, 3)).toBe(5);
        expect(add(-1, 1)).toBe(0);
    });
});
```

## 常用命令

| 命令              | 快捷键            | 功能    |
| --------------- | -------------- | ----- |
| Cline: Ask      | `Ctrl+Shift+L` | 询问 AI |
| Cline: Explain  | `Ctrl+Shift+E` | 解释代码  |
| Cline: Refactor | `Ctrl+Shift+R` | 重构代码  |
| Cline: Generate | `Ctrl+Shift+G` | 生成代码  |

## 高级功能

### 多文件操作

Cline 可以理解和操作多个相关文件：

```bash theme={null}
"将 utils.js 中的函数移动到 helpers.js，并更新所有引用"
```

### 架构设计

生成项目架构：

```text theme={null}
请为电商后台管理系统设计架构，包含：
- 用户管理
- 商品管理
- 订单处理
- 数据分析
使用 React + Node.js + PostgreSQL
```

### 代码审查

```text theme={null}
Review PR:
- 检查代码规范
- 发现潜在 bug
- 性能优化建议
- 安全漏洞扫描
```

## 使用技巧

### 1. 上下文管理

提供更好的上下文：

```typescript theme={null}
// @context: React 组件用于用户认证
// @requirements: 支持 OAuth2 登录流程
// @constraints: 兼容 NextJS 13+

// AI 基于上下文生成更准确的代码
```

### 2. 自定义提示词

在设置中配置：

```json theme={null}
{
    "cline.customPrompts": {
        "codeReview": "审查代码，关注性能、安全、规范",
        "optimize": "优化代码性能和可读性",
        "document": "生成详细的中文文档"
    }
}
```

### 3. 项目级配置

创建 `.cline/config.json`：

```json theme={null}
{
    "model": "claude-sonnet-4-6",
    "temperature": 0.7,
    "language": "zh-CN",
    "codeStyle": {
        "naming": "camelCase",
        "indent": 4,
        "quotes": "single"
    }
}
```

## 故障排除

### 连接失败

检查配置：

* Base URL：`https://api2.laozhang.ai/v1`
* API 密钥是否有效
* 网络连接是否正常

### 响应超时

解决方案：

1. 使用更快的模型
2. 减少请求复杂度
3. 分解大任务

### 生成质量差

改进方法：

1. 提供更多上下文
2. 使用更强大的模型
3. 明确指定需求

## 最佳实践

### 1. 模型选择策略

| 任务类型  | 推荐模型                                           | 成本级别 | 原因           |
| ----- | ---------------------------------------------- | ---- | ------------ |
| 简单补全  | `gpt-4.1-mini` / `gemini-2.5-flash`            | 极低   | 速度快，成本低      |
| 代码生成  | `claude-sonnet-4-6` / `o4-mini`                | 中等   | 编程能力强        |
| 复杂推理  | `o3` / `deepseek-r1`                           | 中低   | 推理能力强，o3 已降价 |
| 架构设计  | `deepseek-r1` + `claude-sonnet-4-6`            | 低    | 先规划后实现，节省成本  |
| 代码审查  | `gemini-3.1-pro-preview` / `claude-sonnet-4-6` | 中等   | 长上下文，理解力强    |
| 批量重构  | `deepseek-chat` / `qwen-turbo`                 | 极低   | 快速经济         |
| 文档生成  | `gpt-4.1` / `qwen-max`                         | 中低   | 表达自然流畅       |
| 长文本处理 | `gemini-2.5-pro` (2M)                          | 中等   | 超长上下文支持      |

### 2. 提示词优化

```text theme={null}
❌ 不好的提示：修复这个函数

✅ 好的提示：修复 calculateTotal 函数中的浮点数精度问题，
确保金额计算准确到小数点后两位
```

### 3. 渐进式开发

1. 先生成基础框架
2. 逐步添加功能
3. 最后优化性能
4. 添加错误处理

### 4. 安全意识

* 不在代码中包含敏感信息
* 审查 AI 生成的代码
* 验证第三方依赖
* 注意安全漏洞

## 集成工作流

### Git 集成

```bash theme={null}
# 自动生成 commit message
git add .
# Cline: 根据改动生成 commit message
```

### 测试驱动开发

1. 先写测试用例
2. Cline 生成实现代码
3. 运行测试验证
4. 迭代优化

### CI/CD 集成

生成配置文件：

```yaml theme={null}
# Cline 可以生成 GitHub Actions 配置
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run tests
        run: npm test
```

## Token 优化与成本控制

### 1. 监控 Token 使用

* **实时监控**：在 Cline 侧边栏查看估算成本
* **会话限制**：保持会话简短，避免上下文累积
* **定期重置**：长任务分多个会话完成

### 2. 智能模型切换

```text theme={null}
规划阶段 → DeepSeek-R1 或 o3（推理能力强，成本低）
实现阶段 → Claude-4-Sonnet 或 o4-mini（编程能力最强）
简单任务 → GPT-4.1-Mini 或 Gemini-2.5-Flash（速度快）
长文本 → Gemini-2.5-Pro（2M 上下文）
```

### 3. 使用 .clinerules 配置

创建项目根目录下的 `.clinerules` 文件：

```text theme={null}
# 限制 Cline 操作范围
- 不允许修改 node_modules
- 不允许删除重要文件
- 限制单次修改文件数量
- 要求确认破坏性操作
```

### 4. 替代方案降低成本

#### GitHub Copilot Pro 集成

* 月费仅 \$10，无限使用
* 通过 VSCode LM API 使用
* 适合高频使用场景

#### 本地模型 (Ollama)

```bash theme={null}
# 安装 Ollama 并运行本地模型
ollama run deepseek-coder:6.7b
ollama run qwen2.5-coder:7b
ollama run codellama:13b
```

#### 使用国产模型降低成本

* `qwen-turbo`（阿里通义千问）
* `glm-4`（智谱清华系）
* `ernie-4.0`（百度文心一言）

### 5. 缓存优化

* 使用 Requesty Router 等服务
* 可节省超过 50% 的 API 成本
* 自动缓存重复请求

## 最佳实践进阶

### 1. Plan/Act 模式使用

* **Plan 模式**：用于设计和审查，只读不改
* **Act 模式**：直接实现，适合简单任务
* **模型记忆**：Cline 会记住每种模式的模型偏好

### 2. 上下文管理技巧

```typescript theme={null}
// 明确的上下文注释
// @context: React 18 + TypeScript 5
// @requirements: 支持 SSR，兼容 Next.js 14
// @constraints: 不使用外部状态管理库
// @performance: 首屏加载 < 3s
```

### 3. 任务管理系统

* **收藏重要对话**：使用星标功能
* **导出有价值内容**：保存为 Markdown
* **任务排序**：按成本、Token 使用量排序
* **批量清理**：定期清理低价值会话

### 4. 避免 Token 爆炸

```text theme={null}
❌ 错误做法：
- 在同一会话中处理多个无关任务
- 让 Cline 读取整个大型代码库
- 不断修改需求导致上下文混乱

✅ 正确做法：
- 每个功能开新会话
- 只包含相关文件
- 明确需求后再开始
- 完成后立即提交代码
```

### 5. 成本效益分析

| 场景      | 传统开发时间 | Cline 成本 | 时间节省   | ROI |
| ------- | ------ | -------- | ------ | --- |
| CRUD 模块 | 4 小时   | \$5-10   | 3.5 小时 | 极高  |
| 复杂重构    | 2 天    | \$20-50  | 1.5 天  | 高   |
| 架构设计    | 1 周    | \$50-100 | 5 天    | 高   |

### 6. 工作流优化

```bash theme={null}
# 1. 规划阶段（使用推理模型）
"使用 o3 或 DeepSeek-R1 分析需求并制定架构方案"

# 2. 实现阶段（使用编程专精模型）
"切换到 Claude-4-Sonnet 或 o4-mini 实现核心功能"

# 3. 测试优化（使用快速模型）
"使用 Gemini-2.5-Flash 或 GPT-4.1-Mini 进行单元测试和优化"

# 4. 文档阶段（使用综合模型）
"使用 GPT-4.1 或 Qwen-Max 生成项目文档"

# 5. 代码审查（使用长上下文模型）
"使用 Gemini-2.5-Pro 进行全面的代码审查"
```

## 性能优化

### 1. 模型切换

根据任务选择模型：

* 开发阶段：轻量模型
* 复杂任务：高级模型
* 生产环境：平衡性能和成本

### 2. 缓存策略

* 启用响应缓存
* 缓存常用代码片段
* 定期清理缓存

### 3. 请求优化

* 批量处理相关请求
* 使用流式响应
* 设置合理超时

需要更多帮助？请查看 [使用场景总览](/scenarios)。