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

VSCode Cline Codeium OpenSpec DeepSeek 完整配置指南 最终方案概述组件用途费用VSCode代码编辑器免费Codeium (Windsurf)Tab 补全 生成注释免费ClineAI Agent复杂任务、多文件操作免费OpenSpec规范驱动开发复杂功能管理免费DeepSeek APICline 和 OpenSpec 的后端模型按量付费约10-20元/月总成本约 10-20 元/月 前置准备1. 安装 VSCode从 code.visualstudio.com 下载安装2. 安装 Node.jsOpenSpec 和 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点击创建⚠️立即复制完整密钥并保存关闭后不再显示 第一步安装 CodeiumTab 补全 注释生成1. 安装插件打开 VSCode按CtrlShiftX打开扩展商店搜索“Windsurf Plugin”或“Codeium”找到“Windsurf Plugin (formerly Codeium)”下载量 3.7M点击Install2. 登录授权安装后会自动弹出授权窗口点击允许(A)浏览器中完成登录可用 GitHub/Google 账号登录成功后VSCode 右下角会出现 Codeium 图标3. 配置中文注释生成点击侧边栏 Codeium 图标打开Windsurf Chat点击齿轮图标⚙️或Advanced找到“Custom Chat Instructions”输入框输入以下内容并保存Javadoc 注释用中文重启 VSCode 生效4. 验证打开 Java 文件输入System.out.应出现灰字补全提示将光标放在方法上点击Generate Javadoc应生成中文注释 第二步安装 ClineAI Agent1. 安装插件打开扩展商店搜索“Cline”找到并安装2. 配置 DeepSeek API点击侧边栏Cline 图标机器人图标首次使用会显示选项选择“Bring my own API key”选择“DeepSeek”或 “OpenAI Compatible”填写以下信息配置项值API Key你保存的 DeepSeek API KeyModeldeepseek-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执行npminstall-gfission-ai/openspeclatest验证安装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按CtrlShiftP→Cline: Open在输入框中输入/应该能看到opsx-propose、opsx-apply等命令 第四步OpenSpec 使用流程核心概念OpenSpec 的核心是“提案先行”在写代码之前先和 AI 对齐要做什么生成提案文档确认后再让 AI 实现。完整工作流/opsx-proposePlan Mode ↓ 创建提案文档 ↓ 人工审查提案 ↓ /opsx-applyAct Mode ↓ AI 按任务清单写代码 ↓ 验证代码 ↓ /opsx-archive ↓ 归档更新主规范具体操作示例场景在Constants.java中添加一个常量步骤 1创建提案在 Cline 中Plan Mode/opsx-propose 在 Constants 类中增加用户侧均价常量值为 37.778AI 会在openspec/changes/下创建提案目录包含三个文件文件内容proposal.md为什么做、做什么、影响范围design.md技术方案类型、命名、位置tasks.md具体任务清单可勾选步骤 2审查提案打开openspec/changes/[变更名]/目录检查proposal.md中的描述是否准确检查tasks.md中的任务是否完整如需修改直接编辑文件或告诉 AI 修改这一步很重要在写代码前发现问题修改成本最低步骤 3执行实施确认提案无误后在 Cline 中切换到 Act Mode/opsx-applyAI 会读取tasks.md中的任务清单逐项完成创建/修改文件、添加代码每完成一项标记[x]步骤 4验证运行mvn clean compile确认编译通过手动测试功能是否正常检查tasks.md是否全部标记为[x]步骤 5归档验证通过后在 Cline 中Act Mode/opsx-archiveAI 会将规范合并到openspec/specs/永久记录将变更目录移动到openspec/changes/archive/斜杠命令速查表命令模式作用/opsx-propose 需求描述Plan创建变更提案/opsx-applyAct按任务清单实施代码/opsx-archiveAct归档已完成的变更/opsx-explorePlan探索分析需求 第五步验证全部环境验证 Codeium打开 Java 文件输入System.out.应有灰字补全验证 ClineCtrlShiftP→Cline: Open输入帮我在 Constants.java 中添加一个常量 TEST_MAX 10Cline 应自动创建/修改文件验证 OpenSpec在 Cline 中输入/应看到opsx-*命令输入/opsx-propose 测试 OpenSpec 是否正常工作应在openspec/changes/下生成提案目录⚠️ 常见问题和避坑指南Codeium 相关问题解决方案安装后没有补全检查右下角状态栏图标 →CtrlShiftP→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终端 成本预估项目月均费用Codeium免费Cline免费OpenSpec免费DeepSeek API约 10-20 元正常开发强度建议首次使用可先充值 10 元能用 1-2 个月。 相关链接VSCode 下载Node.js 下载DeepSeek 开放平台Codeium 官网Cline GitHubOpenSpec GitHub✅ 配置完成检查清单VSCode 已安装Node.js ≥ v20.19.0DeepSeek API Key 已创建并保存Codeium 插件已安装并登录Codeium 中文注释已配置Cline 插件已安装Cline 已配置 DeepSeek API KeyCline 语言已设为简体中文OpenSpec CLI 已安装项目已执行openspec initCline 中/能看到opsx-*命令Tab 补全功能正常Cline 能正常读写文件OpenSpec 能正常创建提案全部打勾后环境配置完成可以开始编码了这份文档包含了完整的配置步骤和使用指南如果有需要补充或修改的内容随时告诉我