OpenCode + DeepSeek 保姆级教程
上一篇文章我们讲了 Claude Code + cc-switch + DeepSeek 的安装配置。那套方案很强，但它主要还是命令行工具，对很多普通用户来说，上手门槛确实偏高。
这篇文章继续讲一个更适合国内用户的 AI Agent 工具：OpenCode。它开源、支持 DeepSeek、支持桌面端和编辑器使用，也可以直接通过 DeepSeek API 接入，整体使用门槛比纯命令行的 Claude Code 低很多。
本文路线
这篇文章最终要做成几件事：
-
认识 OpenCode
-
安装 OpenCode
-
准备 DeepSeek API Key
-
直接在 OpenCode 里配置 DeepSeek
-
学会 OpenCode 的基本使用方式
-
如果你想管理多个模型，再用 cc-switch 辅助配置
为什么这次优先讲 OpenCode？
因为 Claude Code 本质上是命令行工具。它很强，但对普通用户来说，黑底窗口、命令输入、权限确认、路径切换，这些东西都会带来额外理解成本。
OpenCode 的优势在于，它不只是一条命令。它有终端版本，也有桌面端 Beta、IDE 插件和 Web 形态。你可以继续用命令行，也可以在更接近图形界面的环境里使用它。
更重要的是，OpenCode 可以直接接入 DeepSeek。DeepSeek 国内直连、充值方便、按量计费，对中文任务也比较友好。对多数日常任务来说，比如整理文章、分析文件、修改代码、生成脚本、处理项目资料，OpenCode + DeepSeek 已经非常够用。
它还有几个适合长期使用的点
- 开源，代码透明，工具本身不被单一商业平台完全绑定
- 支持多种模型，不只能用某一家模型
- 可以连接本地项目，让 AI 直接理解你的文件和目录
- 内置 OpenCode Zen 这类模型入口，部分模型可能有免费或限免额度
- 对隐私更友好，你可以明确知道自己接入的是哪个模型、用的是哪个 API
- 对国内用户更顺手，DeepSeek API 不需要复杂网络环境
这篇文章会教会你
安装 OpenCode，配置接入 DeepSeek，搭建专属你的本地 AI Agent。
1. OpenCode 是什么
OpenCode 是一个开源的 AI Agent 工具。
你可以把它理解成一个能真正帮你操作项目的 AI 助手。它不是普通聊天窗口，不只是你问一句它答一句，而是可以读取文件、理解目录、修改代码、执行命令、生成文档、整理资料。
你可以让它做很多你需要耗时很久做的事，比如：
一堆会议纪要，让它整理成待办、责任人、截止时间项目出错了，让它读报错、定位文件、尝试修复、跑验证一个文件夹里很多资料，让它读完后总结重点、列出风险Excel/CSV 数据太乱，让它清洗、分类、生成统计说明老板给了一个模糊需求，让它拆成执行清单每周工作内容散在聊天和文档里，让它整理周报下载了一堆资料，让它按主题重命名、归档、做索引......普通 AI 聊天工具更适合单次问答。OpenCode 这类 Agent 工具更适合处理一个完整任务。
它的核心价值不是“多一个聊天软件”，而是让 AI 进入你的真实工作目录，帮你完成电脑里的具体事情。
2. 安装 OpenCode
OpenCode 官方地址：
https://OpenCode.ai下载地址：
https://OpenCode.ai/download打开下载页后，你一般会看到几种入口：
- Terminal
- Desktop Beta
- OpenCode Extensions
- OpenCode Integrations
如果你是普通用户，建议优先看 Desktop Beta。如果你是程序员，或者已经习惯终端，可以用 Terminal。如果你平时主要在 VS Code、Cursor、JetBrains 这类编辑器里写代码，可以再考虑 IDE Extension。
这里默认选择 OpenCode 桌面版，也就是 Desktop Beta。
根据你的系统以及芯片选择对应版本进行下载。
下载完成后，按普通软件的安装方式安装即可。
Mac 用户通常是打开 .dmg，把 OpenCode 拖到 Applications。
Windows 用户通常是打开 .exe 或 .msi 安装包，然后一路下一步。
安装完成后，打开 OpenCode，如下图。
确认是从官网（OpenCode.ai）下载安装的情况下，按系统提示授予必要权限即可。OpenCode 是开源项目，透明度更高，但涉及敏感文件时仍然要谨慎。
3. 准备 DeepSeek API Key
如果你已经看过上一篇 Claude Code + cc-switch 教程，并且已经申请过 DeepSeek API Key，这一步可以跳过。
上一篇文章里我已经详细写过：
- 如何注册 DeepSeek 开放平台
- 如何创建 API Key
- 如何充值
- API Key 为什么要保存好
- DeepSeek API 大概怎么计费
所以这里不再重复展开。没看过的可以先回到上一篇，找到“申请 DeepSeek API Key”那一节。
DeepSeek 开放平台地址：
https://platform.DeepSeek.com简单说，你需要准备一个这样的东西：
sk-xxxxxxxxxxxxxxxxxxxxxxxx这个就是 DeepSeek API Key。
注意三件事：
- API Key 只在自己的电脑上使用，不要发给别人
- API Key 不要截图发到群里
- API Key 不要写进公开文章、公开代码仓库、评论区
OpenCode 后续调用 DeepSeek，本质上就是用这个 Key 去调用 DeepSeek 的模型。
4. 在 OpenCode 里配置 DeepSeek
4.1 配置提供商
这是本文推荐的路线。如果你只想方便使用 DeepSeek，不想折腾网络问题，也不需要频繁切换很多模型，就直接配置 OpenCode。这样步骤最少，也最容易理解。
打开 OpenCode，点击设置 -> 提供商 -> 查看更多提供商，如下图。
在页面搜索 DeepSeek 后，选择 DeepSeek，并根据提示粘贴你的 DeepSeek API Key。
API Key 就是你在 DeepSeek 开放平台创建的那串 sk- 开头的内容。
注意：
-
前后不要多复制空格
-
API Key 的格式是
sk-XXXXXXXXXXXXXXXX -
不要把 Key 发给别人
如果你有多个模型，想通过 cc-switch 管理 OpenCode，可以先跳到 5.3，看完后再回来继续阅读。
配置成功后，OpenCode 会提示 DeepSeek 已连接。
4.2 测试是否配置成功
点击主界面左上角的加号，打开一个你的工作目录。
选择 DeepSeek 模型。日常使用建议优先选择：DeepSeek-V4-Pro。
如果你只是做一些轻量任务，比如改几句话、写简单说明、生成短文本，也可以选择更便宜、更快的 DeepSeek-V4-Flash。
这里不用太纠结。先跑通最重要。后续你真正用起来，会慢慢知道哪些任务需要更强模型，哪些任务用便宜模型就够。
如图配置完成后，可以先问一个简单问题：
你现在是什么模型？如果它能正常回答，说明 OpenCode 已经可以调用模型了。
更稳妥的验证方式，是打开 DeepSeek 后台，看 API 用量有没有变化。
DeepSeek 后台地址：https://platform.DeepSeek.com
如果刚刚提问后，用量页面有变化，说明请求确实走了 DeepSeek。
其余基础设置的话可以像我一样调整配置一下：
打开自动接受权限
打开“显示推理摘要”“展开 shell 工具部分”“展开编辑工具部分”（这样能清晰知道它在干什么）。
5. OpenCode 怎么用
5.1 基础用法
装好和配置好只是第一步。真正有价值的是让它帮你做具体事情。
OpenCode 不是普通聊天软件，它适合围绕一个目录工作。
比如你有一个工作文件夹，可以在 OpenCode 里打开这个文件夹，设置为工作区，然后通过发消息的形式让它读取里面的文档。
第一次不要直接让它大规模改项目。建议先让它做阅读、总结、检查类任务。例如：
阅读当前文件夹，告诉我这里主要有哪些文件，每个文件大概是做什么的。帮我总结 article.md 的主要内容，不要修改文件。检查这篇文章有没有结构不清楚、重复、跳跃的地方，先只提建议。这样你可以先观察它是否理解正确。如果它总结得靠谱，再让它继续修改。
下命令时不需要反复打磨表达，想到什么说什么就行，甚至可以使用语音转文字。比如我这里就是用语音转文字生成的任务，它会提炼你的思路，再决定怎么思考以及如何操作。
5.2 使用技巧
建议你养成这几个习惯：
- 使用时需要阅读它的推理逻辑，在它跑偏时及时纠正
- 改之前让它先说出计划
- 一次只交代一个明确的详细的目标
- 涉及重要文件时，先让它只提建议
- 改完后让它告诉你修改了哪些地方
AI Agent 很强，但它不是完全不会犯错。
你给的目标越清楚、越明确，它做出来的结果越稳定。
5.3 通过 cc-switch 管理 OpenCode 和 DeepSeek
如果你只用 DeepSeek，前面的直接配置就够了。如果你有这些需求，再考虑 cc-switch：
- 想在 DeepSeek、Qwen、GLM、豆包等多个模型之间切换
- 想同时管理 Claude Code、OpenCode、Codex、Gemini CLI
- 不想手动改不同工具的配置
- 希望通过图形界面统一管理 API Key 和模型映射
cc-switch 的作用，就是把多个 AI 工具和多个模型渠道统一管理起来。
上一篇文章我已经详细写过 cc-switch 的安装方式，这里不重复安装过程。没装过的，先回到上一篇文章看“安装 cc-switch”那一节。
cc-switch 官网：
https://ccswitch.io/zhcc-switch GitHub 下载页：
https://github.com/farion1231/cc-switch/releases
6. 常见问题
Q1：OpenCode 和 Claude Code 有什么区别？
Claude Code 是 Anthropic 官方的 AI Agent，能力很强，但主要使用方式是命令行。
OpenCode 是开源 AI Agent，支持更多形态，比如终端、桌面端、IDE 插件，也支持接入不同模型。
简单说：
如果你更在意国内可用、配置灵活、图形界面、模型可切换，OpenCode 更适合先上手。
Q2：DeepSeek API 要花钱吗？
要。但一个月花不了几十块钱。
DeepSeek API 是按量计费，不是包月聊天会员。好处是日常使用成本通常很低，用多少算多少。普通文章修改、简单代码分析、资料整理，一次请求一般不会太贵。但如果你让它读取大量文件、生成很长内容、连续跑很多轮，费用就会增加。价格以 DeepSeek 官网最新价格为准。
DeepSeek 价格页：https://api-docs.DeepSeek.com/zh-cn/quick_start/pricing
Q3：为什么我配置后不能用？
优先检查这几个点：
- API Key 有没有复制完整
- API Key 前后有没有多余空格
- DeepSeek 账户里是否有余额
- OpenCode 是否选中了 DeepSeek 模型
- 当前网络是否能访问 DeepSeek API
- 配置后是否重启了 OpenCode
如果还是不行，可以先回到 DeepSeek 后台，确认 Key 是否存在、账户是否正常。
Q4：什么是 cc-switch？
等你后面同时用了多个工具，比如 Claude Code、OpenCode、Codex、Gemini CLI，或者你想在多个模型供应商之间切换，再用 cc-switch 统一管理。
Q5：OpenCode 会不会泄露我的文件？
OpenCode 本身开源，透明度比闭源工具高。作为一个 AI Agent 工具，它本身不会主动收集你的所有数据。但是任何 AI Agent 工具，只要调用云端模型，就会把本次任务相关内容发送给对应模型服务商。本文介绍的云端模型是 DeepSeek，所以你要按 DeepSeek 的平台规则理解数据使用边界。
所以你要理解一个原则：即使模型平台承诺保护隐私，也不要把敏感文件、密码、密钥、合同原文、公司内部机密直接交给 AI。
7. 总结
这篇文章解决的是一个很具体的问题：
让国内用户用 OpenCode 直接接入 DeepSeek，并且跑起来。
如果你已经按上一篇文章装好了 Claude Code + cc-switch，那你现在有两条路线：
- 想体验更强的命令行 Agent：继续用 Claude Code
- 想要更低门槛、更灵活、更适合图形界面的方式：试试 OpenCode
我的建议是：
先把 OpenCode + DeepSeek 跑通。
不要一上来研究十几个模型，也不要一开始就纠结哪个参数最优。先拿你真实工作里的一个小任务测试，比如改一篇文章、总结一个文件夹、分析一个项目。
能帮你省时间的工具，才值得继续研究。
后面如果你需要在多个模型之间切换，再把 cc-switch 接进来。
以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧。
如果想第一时间收到后续教程，也可以给我一个星标。
谢谢你看我的文章
晴时有记，阴时不更
我是晴天，我们下次再见。
相关链接
- OpenCode 官网：
https://OpenCode.ai - OpenCode 下载页：
https://OpenCode.ai/download - DeepSeek OpenCode 接入文档：
https://api-docs.DeepSeek.com/zh-cn/guides/agent_integrations/OpenCode - DeepSeek 开放平台：
https://platform.DeepSeek.com - DeepSeek 模型与价格：
https://api-docs.DeepSeek.com/zh-cn/quick_start/pricing - cc-switch 官网：
https://ccswitch.io/zh - cc-switch GitHub Releases：
https://github.com/farion1231/cc-switch/releases
部分信息可能已经过时