VSCode + Cline + Codeium + OpenSpec + DeepSeek 完整配置指南

约 10-20 元/月。

codermokey

577人浏览 · 2026-05-11 12:03:22

codermokey · 2026-05-11 12:03:22 发布

VSCode + Cline + Codeium + OpenSpec + DeepSeek 完整配置指南

📋 最终方案概述

组件	用途	费用
VSCode	代码编辑器	免费
Codeium (Windsurf)	Tab 补全 + 生成注释	免费
Cline	AI Agent（复杂任务、多文件操作）	免费
OpenSpec	规范驱动开发（复杂功能管理）	免费
DeepSeek API	Cline 和 OpenSpec 的后端模型	按量付费（约10-20元/月）

总成本：约 10-20 元/月

📦 前置准备

1. 安装 VSCode

从 code.visualstudio.com 下载安装

2. 安装 Node.js（OpenSpec 和 Cline 依赖）

从 nodejs.org 下载 LTS 版本（≥ v20.19.0）
安装完成后，打开终端（CMD/PowerShell）验证：
```
node --version   # 应显示 v20.19.0 或更高
```

3. 注册 DeepSeek 账号并获取 API Key

访问 platform.deepseek.com 注册登录
进入控制台 → API Keys → 创建 API key
输入名称（如 Cline-VSCode），点击创建
⚠️ 立即复制完整密钥并保存（关闭后不再显示）

🔌 第一步：安装 Codeium（Tab 补全 + 注释生成）

1. 安装插件

打开 VSCode，按 Ctrl+Shift+X 打开扩展商店
搜索 “Windsurf Plugin” 或 “Codeium”
找到 “Windsurf Plugin (formerly Codeium)”（下载量 3.7M+）
点击 Install

2. 登录授权

安装后会自动弹出授权窗口，点击 允许(A)
浏览器中完成登录（可用 GitHub/Google 账号）
登录成功后，VSCode 右下角会出现 Codeium 图标

3. 配置中文注释生成

点击侧边栏 Codeium 图标打开 Windsurf Chat
点击齿轮图标（⚙️）或 Advanced
找到 “Custom Chat Instructions” 输入框
输入以下内容并保存：
```
Javadoc 注释用中文
```
重启 VSCode 生效

4. 验证

打开 Java 文件，输入 System.out.，应出现灰字补全提示
将光标放在方法上，点击 Generate Javadoc，应生成中文注释

🤖 第二步：安装 Cline（AI Agent）

1. 安装插件

打开扩展商店，搜索 “Cline”
找到并安装

2. 配置 DeepSeek API

点击侧边栏 Cline 图标（机器人图标）
首次使用会显示选项，选择 “Bring my own API key”
选择 “DeepSeek”（或 “OpenAI Compatible”）
填写以下信息：

配置项	值
API Key	你保存的 DeepSeek API Key
Model	`deepseek-chat`（或 `deepseek-v4-pro`）

⚠️ 如果只有 deepseek-chat 和 deepseek-reasoner，选 deepseek-chat 即可

3. 设置中文语言

点击 Cline 对话框右上角的 齿轮图标（⚙️）
找到 Preferred Language，选择 “Simplified Chinese - 简体中文”
点击 Done 保存

4. 配置自动批准（可选）

在设置中找到 Auto-approve 部分
推荐配置：

选项	是否勾选
Read project files	✅ 勾选
Read all files	❌ 不勾选
Edit project files	✅ 勾选
Execute safe commands	✅ 勾选
Execute all commands	❌ 不勾选（安全）
Use the browser	❌ 不勾选

📋 第三步：安装 OpenSpec（规范驱动开发）

1. 安装 OpenSpec CLI

打开终端（CMD/PowerShell），执行：

npm install -g @fission-ai/openspec@latest

验证安装：

openspec --version   # 应显示版本号

⚠️ 如果提示 'openspec' 不是内部或外部命令，说明 npm 全局路径未加入 PATH

执行 npm config get prefix 获取路径

将该路径添加到系统环境变量 PATH 中

重新打开终端

2. 在项目中初始化 OpenSpec

打开你的 Java 项目根目录
在终端执行：
```
openspec init
```
按提示选择 AI 工具：
- 选择 Cline
- 选择 Continue（可选，但推荐）
选择语言：zh-CN（简体中文）

3. 验证生成的文件

初始化后，项目根目录会新增：

your-project/
├── AGENTS.md              # AI 协作指引（告诉 AI 如何工作）
├── openspec/
│   ├── specs/             # 主规范目录（已实现的功能）
│   ├── changes/           # 进行中的变更提案
│   └── AGENTS.md          # OpenSpec 专用指引
├── .clinerules/           # Cline 斜杠命令
│   └── workflows/
│       ├── opsx-propose.md   # 创建提案命令
│       ├── opsx-apply.md     # 执行任务命令
│       ├── opsx-archive.md   # 归档命令
│       └── opsx-explore.md   # 探索命令

4. 验证斜杠命令是否生效

重启 VSCode
按 Ctrl+Shift+P → Cline: Open
在输入框中输入 /
应该能看到 opsx-propose、opsx-apply 等命令

🎯 第四步：OpenSpec 使用流程

核心概念

OpenSpec 的核心是 “提案先行”：在写代码之前，先和 AI 对齐"要做什么"，生成提案文档，确认后再让 AI 实现。

完整工作流

/opsx-propose（Plan Mode）
        ↓
   创建提案文档
        ↓
   人工审查提案
        ↓
/opsx-apply（Act Mode）
        ↓
   AI 按任务清单写代码
        ↓
   验证代码
        ↓
/opsx-archive
        ↓
   归档，更新主规范

具体操作示例

场景：在 Constants.java 中添加一个常量

步骤 1：创建提案

在 Cline 中（Plan Mode）：

/opsx-propose 在 Constants 类中增加用户侧均价常量，值为 37.778

AI 会在 openspec/changes/ 下创建提案目录，包含三个文件：

文件	内容
`proposal.md`	为什么做、做什么、影响范围
`design.md`	技术方案（类型、命名、位置）
`tasks.md`	具体任务清单（可勾选）

步骤 2：审查提案

打开 openspec/changes/[变更名]/ 目录
检查 proposal.md 中的描述是否准确
检查 tasks.md 中的任务是否完整
如需修改，直接编辑文件或告诉 AI 修改

💡 这一步很重要：在写代码前发现问题，修改成本最低

步骤 3：执行实施

确认提案无误后，在 Cline 中切换到 Act Mode：

/opsx-apply

AI 会：

读取 tasks.md 中的任务清单
逐项完成（创建/修改文件、添加代码）
每完成一项标记 [x]

步骤 4：验证

运行 mvn clean compile 确认编译通过
手动测试功能是否正常
检查 tasks.md 是否全部标记为 [x]

步骤 5：归档

验证通过后，在 Cline 中（Act Mode）：

/opsx-archive

AI 会：

将规范合并到 openspec/specs/（永久记录）
将变更目录移动到 openspec/changes/archive/

斜杠命令速查表

命令	模式	作用
`/opsx-propose 需求描述`	Plan	创建变更提案
`/opsx-apply`	Act	按任务清单实施代码
`/opsx-archive`	Act	归档已完成的变更
`/opsx-explore`	Plan	探索分析需求

🧪 第五步：验证全部环境

验证 Codeium

打开 Java 文件，输入 System.out.，应有灰字补全

验证 Cline

Ctrl+Shift+P → Cline: Open
输入：帮我在 Constants.java 中添加一个常量 TEST_MAX = 10
Cline 应自动创建/修改文件

验证 OpenSpec

在 Cline 中输入 /，应看到 opsx-* 命令
输入：/opsx-propose 测试 OpenSpec 是否正常工作
应在 openspec/changes/ 下生成提案目录

⚠️ 常见问题和避坑指南

Codeium 相关

问题	解决方案
安装后没有补全	检查右下角状态栏图标 → `Ctrl+Shift+P` → `Reload Window`
注释生成还是英文	确认 Custom Chat Instructions 已保存 → 重启 VSCode
登录失败	检查网络，可能需要代理

Cline 相关

问题	解决方案
API Key 无效	检查是否复制完整；确认 DeepSeek 账户有余额
Plan/Act 分不清	Plan=只读分析；Act=可写文件。复杂任务先用 Plan
执行危险命令	不要勾选 “Execute all commands”，会弹窗确认

OpenSpec 相关

问题	解决方案
`openspec` 命令找不到	npm 全局路径未加入 PATH → 添加后重启终端
斜杠命令不显示	重启 VSCode；确认 `.clinerules/workflows/` 目录存在
`/opsx-apply` 没反应	确认已在 Act Mode；确认当前有进行中的提案
提案审查后发现要改	手动编辑 `proposal.md`，或告诉 AI 修改

Node.js 相关

问题	解决方案
`node --version` 版本过低	去 nodejs.org 下载 LTS 版本重新安装
`npm install -g` 权限错误	Windows：以管理员身份运行终端

📝 日常使用速查表

任务	用什么	怎么用
写代码，Tab 补全	Codeium	正常打字，按 Tab 接受
生成中文注释	Codeium	光标放方法上 → Generate Javadoc
解释代码	Cline	粘贴代码问"这段代码做什么"
生成简单代码	Cline	“帮我写一个 UserService”
修改现有代码	Cline (Act Mode)	“把 findAll 改成返回 Page”
执行 Maven 命令	Cline (Act Mode)	“运行 mvn clean test”
开发复杂功能	OpenSpec + Cline	`/opsx-propose` → 审查 → `/opsx-apply`
查看进行中的提案	-	`openspec list`（终端）