零基础 Vibe Coding起步：用 OpenCode 桌面版连接 DeepSeek

写在前面：这篇教程会完成什么？

这篇文章会带你从一台没有开发环境的电脑开始，完成下面这条流程：

下载 OpenCode 桌面版 → 获取 DeepSeek API Key
→ 在 /model 中选择 DeepSeek → 打开项目文件夹

一、OpenCode 和 DeepSeek 分别做什么？

可以把这套组合理解成：

  • OpenCode 桌面版：工作台和执行者，负责读取、创建、修改本地项目文件；
  • DeepSeek API：背后的 AI 模型，负责理解需求、分析问题和生成代码。

OpenCode 是客户端，DeepSeek 是模型服务。两者连接时需要一把 DeepSeek API Key。

需要注意：DeepSeek 网页聊天和 DeepSeek 开放平台 API 是两套使用方式。本教程使用的是 DeepSeek 开放平台 API，费用从 API 余额中按实际用量扣除。

二、下载 OpenCode 桌面版

打开 OpenCode 官方下载页：
https://opencode.ai/download
在 OpenCode Desktop 区域找到 Windows (x64)，点击下载；
大多数 Windows 10/11 电脑都是 x64。如果你不确定，可以打开 Windows 的“设置 → 系统 → 系统信息”，查看“系统类型”。
如果是Mac电脑，选择对应的安装包下载即可
image.png

下载完成后，双击安装文件。如果 Windows 弹出安全确认窗口，请先核对文件来自 OpenCode 官方网站，再选择继续。

image.png

按照安装向导完成安装。通常保持默认设置即可，不需要手动选择 Node.js、Python 或其他开发组件。

安装完成后，从开始菜单打开 OpenCode。
image.png

三、注册 DeepSeek 开放平台并准备余额

打开 DeepSeek 开放平台：
https://platform.deepseek.com/
注册或登录账号，然后进入余额或充值页面。先充值一笔小额费用即可，新手不必一次充值很多。

模型价格会调整，建议随时查看 DeepSeek 官方价格页，不要把网上旧教程中的单价当作长期固定价格。

image.png

充值后确认账户中有可用余额。如果余额为 0，后续可能遇到 402 Insufficient Balance 错误。

四、创建 DeepSeek API Key

进入 DeepSeek 开放平台的 API Keys 页面，点击创建新的 API Key。
可以把名称填写为：

1
2
3

opencode-desktop


单独创建一把 Key，后续查看用量、停用或更换时会更方便。
image.png

创建成功后，平台会显示一串通常以 sk- 开头的密钥。点击复制，并暂时保存在安全的位置。

API Key 相当于账号密码。不要把完整 Key 放进博客截图、聊天记录或公开代码仓库。 平台通常只会完整展示一次；如果丢失，删除旧 Key 并重新创建即可。

五、在 OpenCode 桌面版中选择 DeepSeek

回到 OpenCode 桌面客户端，点击底部输入框，输入：

1
/model

部分版本的命令名称可能显示为复数：
1
/models

如果输入 /model 后界面已经出现模型或供应商选择器，就直接继续，不必输入第二条命令。

image.png
在列表中搜索或选择 DeepSeek。
image.png
首次选择 DeepSeek 时，客户端会要求输入 API Key。粘贴刚才复制的 Key，然后确认。
输入时密钥可能显示为圆点或星号，这是正常的安全保护。
image.png
接下来选择 DeepSeek V4 Pro，模型标识通常为：

1
deepseek-v4-pro

如果你更在意响应速度和成本，也可以选择 DeepSeek V4 Flash。本文示例以 V4 Pro 为主。旧文章中常见的 deepseek-chat 和 deepseek-reasoner 已进入退出兼容阶段，新教程不建议继续使用旧名称。

如果 /model 没有弹出 API Key 输入框

不同版本的界面可能稍有差异。此时在输入框执行：

1
/connect

选择 DeepSeek，粘贴 API Key；完成后再输入 /model 或 /models 选择 DeepSeek 模型。
这是当前官方文档中仍然保留的兼容配置流程：

1
/connect → DeepSeek → 输入 API Key → /models → 选择模型

六、创建并打开第一个项目文件夹

在桌面或“文档”中创建一个新文件夹，例如：

1
my-first-vibe-project

不要直接选择整个桌面、整个文档目录或包含重要资料的文件夹。OpenCode 会获得当前项目目录中的文件访问能力，单独建文件夹可以避免误改无关内容。

回到 OpenCode，点击 Open Project、Open Folder 或界面中对应的“打开文件夹”按钮，选择刚才创建的文件夹。
不同版本的按钮文字可能略有不同，核心操作都是“把这个文件夹设为当前工作目录”。
image.png

打开后，确认窗口顶部或侧边栏显示的是正确项目名称，并确认当前模型是 DeepSeek V4 Pro。
image.png

七、用一句中文创建第一个网页

在 OpenCode 输入下面这段需求：

1
2
3
4
5
6
7
8
请在当前文件夹中创建一个可以直接打开的个人待办清单网页。
要求：
1. 使用简体中文；
2. 页面简洁、明亮，适配电脑和手机；
3. 可以添加任务、勾选完成、删除任务；
4. 刷新网页后任务仍然保留；
5. 只使用 HTML、CSS 和 JavaScript，不使用需要额外安装的框架；
6. 完成后检查主要功能，并告诉我创建了哪些文件以及如何预览。

OpenCode 可能会请求创建或修改文件。先查看文件名和路径，确认都在当前项目文件夹中，再允许操作。
不要看到确认按钮就一路点击。AI 很强，但文件操作权限仍然应该由你控制。
完成后，侧边栏或项目文件夹中通常会出现：

1
2
3
index.html
style.css
script.js

按照 OpenCode 给出的预览说明打开网页。对于这个不使用框架的示例，通常双击 index.html 就能用浏览器查看。

八、继续修改：真正的 Vibe Coding 从这里开始

第一版不需要完美。观察页面后，把下一轮想法继续告诉 AI：

1
2
3
4
5
6
现在功能正常，请继续改进：
1. 增加深色模式按钮；
2. 增加“全部、进行中、已完成”三个筛选按钮；
3. 给完成任务增加轻微动画；
4. 保留现有数据和功能；
5. 修改完成后检查手机端布局。

如果结果不对，描述具体现象，不要只说“优化一下”。例如：
1
2
在手机宽度下，删除按钮超出了任务卡片右侧。
请只修复移动端布局，不要改变桌面端样式和现有功能。

九、新手最好用的提示词公式

一个清楚的需求通常包含五部分：

1
做什么 + 给谁用 + 必须有哪些功能 + 想要什么风格 + 有哪些限制

示例：
1
2
3
4
5
请为刚开始健身的上班族制作一个训练打卡网页。
需要支持添加训练记录、按日期查看、统计本周次数，并把数据保存在本地。
界面使用深蓝色和亮绿色，简洁、有运动感，手机上也要好用。
使用原生 HTML、CSS、JavaScript，不要引入需要安装的框架。
完成后检查所有主要按钮是否可以使用。

十、常见问题

1. Windows 提示 OpenCode 无法启动

确认下载的是 Windows x64 版本，并尝试重新下载安装。OpenCode Desktop 在 Windows 上还依赖 Microsoft Edge WebView2 Runtime；大多数 Windows 10/11 已经自带，如果缺失，可从微软官方渠道安装后重试。

2. /model 没有反应

先输入 /models。如果仍然没有供应商或密钥配置界面，使用：

1
/connect

连接 DeepSeek 后，再返回模型选择器。

3. 提示 401 或 Authentication Fails

API Key 不正确或复制时带入了多余空格。重新复制；如果平台已经不再显示完整 Key，就删除旧 Key 并创建新的。

4. 提示 402 或 Insufficient Balance

DeepSeek API 余额不足。充值后回到 OpenCode 再试。

5. 列表中没有最新 DeepSeek 模型

退出 OpenCode，下载安装最新版桌面客户端。DeepSeek 当前建议使用兼容版本不低于 v1.14.24 的 OpenCode。

6. AI 修改了不该修改的文件

立即停止操作。确认当前打开的是独立项目文件夹，并从备份恢复。不要把整个桌面、文档总目录或重要资料目录作为 OpenCode 项目打开。

十一、安全与费用提醒

开始长期使用前，请养成下面几个习惯：

  • 不公开 API Key，截图前检查并完整打码；
  • 给不同工具创建不同的 Key，泄露后立即删除；
  • 定期查看 API 用量和余额；
  • 每次允许文件操作前先检查路径；
  • 每个项目使用独立文件夹；
  • 重要项目先备份，生成代码经过测试再使用；
  • 不把公司私有代码、客户数据或个人隐私发送给未经授权的模型服务。

    结语

    现在，你已经走完了完整流程：
    1
    2
    3
    安装 OpenCode 桌面版 → 创建 DeepSeek API Key
    → /model 选择 DeepSeek → 打开独立项目文件夹
    → 描述需求 → 检查结果 → 持续迭代
    Vibe Coding 不是让 AI 随便写代码，而是把目标说清楚，观察实际结果，指出具体问题，再一轮轮接近想要的成品。

第一个项目不用很大。个人主页、倒计时、待办清单、课程表、番茄钟、简单记账页面，都很适合作为起点。能运行、能修改、能解决一个小问题，就是很好的第一步。

官方参考资料