更适合国内宝宝的AI工具:OpenCode + DeepSeek 保姆级教程

更适合国内宝宝体质的AI工具：OpenCode + DeepSeek 保姆级教程

上一篇文章我们讲了 Claude Code + cc-switch + DeepSeek 的安装配置。那套方案很强，但它主要还是命令行工具，对很多普通用户来说，上手门槛确实偏高。
这篇文章继续讲一个更适合国内用户的 AI Agent 工具：OpenCode。它开源、支持 DeepSeek、支持桌面端和编辑器使用，也可以直接通过 DeepSeek API 接入，整体使用门槛比纯命令行的 Claude Code 低很多。

OpenCode 官网

本文路线

这篇文章最终要做成几件事：

1. 认识 OpenCode
2. 安装 OpenCode
3. 准备 DeepSeek API Key
4. 直接在 OpenCode 里配置 DeepSeek
5. 学会 OpenCode 的基本使用方式
6. 如果你想管理多个模型，再用 cc-switch 辅助配置

为什么选 OpenCode？

因为 Claude Code 本质上是命令行工具。它很强，但对普通用户来说，黑底窗口、命令输入、权限确认、路径切换，这些东西都会带来额外理解成本。

OpenCode 的优势在于，它不只是一条命令。它有终端版本，也有桌面端 Beta、IDE 插件和 Web 形态。你可以继续用命令行，也可以在更接近图形界面的环境里使用它。

更重要的是，OpenCode 可以直接接入 DeepSeek。DeepSeek 国内直连、充值方便、按量计费，对中文任务也比较友好。对多数日常任务来说，比如整理文章、分析文件、修改代码、生成脚本、处理项目资料，OpenCode + DeepSeek 已经非常够用。

它还有几个适合长期使用的点

1. 开源，代码透明，工具本身不被单一商业平台完全绑定
2. 支持多种模型，不只能用某一家模型
3. 可以连接本地项目，让 AI 直接理解你的文件和目录
4. 内置 OpenCode Zen 这类模型入口，部分模型可能有免费或限免额度
5. 对隐私更友好，你可以明确知道自己接入的是哪个模型、用的是哪个 API
6. 对国内用户更顺手，DeepSeek API 不需要复杂网络环境

这篇文章会教会你

安装 OpenCode，配置接入 DeepSeek，搭建专属你的本地 AI Agent。

1. OpenCode 是什么

OpenCode 是一个开源的 AI Agent 工具。

你可以把它理解成一个能真正帮你操作项目的 AI 助手。它不是普通聊天窗口，不只是你问一句它答一句，而是可以读取文件、理解目录、修改代码、执行命令、生成文档、整理资料。

你可以让它做很多你需要耗时很久做的事，比如：

1. 一堆会议纪要，让它整理成待办、责任人、截止时间
2. 项目出错了，让它读报错、定位文件、尝试修复、跑验证
3.一个文件夹里很多资料，让它读完后总结重点、列出风险
4. Excel/CSV 数据太乱，让它清洗、分类、生成统计说明
5. 老板给了一个模糊需求，让它拆成执行清单
6. 每周工作内容散在聊天和文档里，让它整理周报
7. 下载了一堆资料，让它按主题重命名、归档、做索引
8. ......

普通 AI 聊天工具更适合单次问答。OpenCode 这类 Agent 工具更适合处理一个完整任务。

它的核心价值不是“多一个聊天软件”，而是让 AI 进入你的真实工作目录，帮你完成电脑里的具体事情。

2. 安装 OpenCode

OpenCode 官方地址：

https://opencode.ai

下载地址：

https://opencode.ai/download

打开下载页后，你一般会看到几种入口：

1. Terminal
2. Desktop Beta
3. OpenCode Extensions
4. OpenCode Integrations

如果你是普通用户，建议优先看 Desktop Beta。如果你是程序员，或者已经习惯终端，可以用 Terminal。如果你平时主要在 VS Code、Cursor、JetBrains 这类编辑器里写代码，可以再考虑 IDE Extension。

这里默认选择 OpenCode 桌面版，也就是 Desktop Beta。

根据你的系统以及芯片选择对应版本进行下载。

OpenCode Desktop 下载入口

下载完成后，按普通软件的安装方式安装即可。

Mac 用户通常是打开 .dmg，把 OpenCode 拖到 Applications。

Windows 用户通常是打开 .exe 或 .msi 安装包，然后一路下一步。

安装完成后，打开 OpenCode，如下图。

OpenCode Desktop首页

确认是从官网（opencode.ai）下载安装的情况下，按系统提示授予必要权限即可。OpenCode 是开源项目，透明度更高，但涉及敏感文件时仍然要谨慎。

3. 准备 DeepSeek API Key

如果你已经看过上一篇 Claude Code + cc-switch 教程，并且已经申请过 DeepSeek API Key，这一步可以跳过。

上一篇文章里我已经详细写过：

1. 如何注册 DeepSeek 开放平台
2. 如何创建 API Key
3. 如何充值
4. API Key 为什么要保存好
5. DeepSeek API 大概怎么计费

所以这里不再重复展开。没看过的可以先回到上一篇，找到“申请 DeepSeek API Key”那一节。

DeepSeek 开放平台地址：

https://platform.deepseek.com

简单说，你需要准备一个这样的东西：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

这个就是 DeepSeek API Key。

注意三件事：

1. API Key 只在自己的电脑上使用，不要发给别人
2. API Key 不要截图发到群里
3. API Key 不要写进公开文章、公开代码仓库、评论区

OpenCode 后续调用 DeepSeek，本质上就是用这个 Key 去调用 DeepSeek 的模型。

4. 在 OpenCode 里配置 DeepSeek

4.1 配置提供商

这是本文推荐的路线。如果你只想方便使用 DeepSeek，不想折腾网络问题，也不需要频繁切换很多模型，就直接配置 OpenCode。这样步骤最少，也最容易理解。

打开 OpenCode，点击设置 -> 提供商 -> 查看更多提供商，如下图。

在页面搜索 DeepSeek 后，选择 DeepSeek，并根据提示粘贴你的 DeepSeek API Key。

OpenCode 提供商列表中搜索并选择 DeepSeek

API Key 就是你在 DeepSeek 开放平台创建的那串 sk- 开头的内容。

注意：

1. 前后不要多复制空格
2. API Key 的格式是 sk-XXXXXXXXXXXXXXXX
3. 不要把 Key 发给别人

如果你有多个模型，想通过 cc-switch 管理 OpenCode，可以先跳到 5.3，看完后再回来继续阅读。

配置成功后，OpenCode 会提示 DeepSeek 已连接。

4.2 测试是否配置成功

点击主界面左上角的加号，打开一个你的工作目录。

选择 DeepSeek 模型。日常使用建议优先选择：DeepSeek-V4-Pro。

如果你只是做一些轻量任务，比如改几句话、写简单说明、生成短文本，也可以选择更便宜、更快的 DeepSeek-V4-flash。

OpenCode 工作区中选择 DeepSeek 模型并输入任务

这里不用太纠结。先跑通最重要。后续你真正用起来，会慢慢知道哪些任务需要更强模型，哪些任务用便宜模型就够。

如图配置完成后，可以先问一个简单问题：

你现在是什么模型？

如果它能正常回答，说明 OpenCode 已经可以调用模型了。

更稳妥的验证方式，是打开 DeepSeek 后台，看 API 用量有没有变化。

DeepSeek 后台地址：https://platform.deepseek.com

如果刚刚提问后，用量页面有变化，说明请求确实走了 DeepSeek。

其余基础设置的话可以像我一样调整配置一下：

打开自动接受权限

打开“显示推理摘要”“展开 shell 工具部分”“展开编辑工具部分”（这样能清晰知道它在干什么）。

5. OpenCode 怎么用

5.1 基础用法

装好和配置好只是第一步。真正有价值的是让它帮你做具体事情。

OpenCode 不是普通聊天软件，它适合围绕一个目录工作。

比如你有一个工作文件夹，可以在 OpenCode 里打开这个文件夹，设置为工作区，然后通过发消息的形式让它读取里面的文档。

第一次不要直接让它大规模改项目。建议先让它做阅读、总结、检查类任务。例如：

阅读当前文件夹，告诉我这里主要有哪些文件，每个文件大概是做什么的。

帮我总结 article.md 的主要内容，不要修改文件。
检查这篇文章有没有结构不清楚、重复、跳跃的地方，先只提建议。

这样你可以先观察它是否理解正确。如果它总结得靠谱，再让它继续修改。

下命令时不需要反复打磨表达，想到什么说什么就行，甚至可以使用语音转文字。比如我这里就是用语音转文字生成的任务，它会提炼你的思路，再决定怎么思考以及如何操作。

OpenCode 根据自然语言任务读取文件并生成执行结果

5.2 使用技巧

建议你养成这几个习惯：

1. 使用时需要阅读它的推理逻辑，在它跑偏时及时纠正
2. 改之前让它先说出计划
3. 一次只交代一个明确的详细的目标
4. 涉及重要文件时，先让它只提建议
5. 改完后让它告诉你修改了哪些地方

AI Agent 很强，但它不是完全不会犯错。

你给的目标越清楚、越明确，它做出来的结果越稳定。

5.3 通过 cc-switch 管理 OpenCode 和 DeepSeek

如果你只用 DeepSeek，前面的直接配置就够了。如果你有这些需求，再考虑 cc-switch：

1. 想在 DeepSeek、Qwen、GLM、豆包等多个模型之间切换
2. 想同时管理 Claude Code、OpenCode、Codex、Gemini CLI
3. 不想手动改不同工具的配置
4. 希望通过图形界面统一管理 API Key 和模型映射

cc-switch 的作用，就是把多个 AI 工具和多个模型渠道统一管理起来。

上一篇文章我已经详细写过 cc-switch 的安装方式，这里不重复安装过程。没装过的，先回到上一篇文章看“安装 cc-switch”那一节。

cc-switch 官网：

https://ccswitch.io/zh

cc-switch GitHub 下载页：

https://github.com/farion1231/cc-switch/releases

cc-switch 中统一管理 OpenCode 和多个模型渠道

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：为什么我配置后不能用？

优先检查这几个点：

1. API Key 有没有复制完整
2. API Key 前后有没有多余空格
3. DeepSeek 账户里是否有余额
4. OpenCode 是否选中了 DeepSeek 模型
5. 当前网络是否能访问 DeepSeek API
6. 配置后是否重启了 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，那你现在有两条路线：

1. 想体验更强的命令行 Agent：继续用 Claude Code
2. 想要更低门槛、更灵活、更适合图形界面的方式：试试 OpenCode

我的建议是：

先把 OpenCode + DeepSeek 跑通。

不要一上来研究十几个模型，也不要一开始就纠结哪个参数最优。先拿你真实工作里的一个小任务测试，比如改一篇文章、总结一个文件夹、分析一个项目。

能帮你省时间的工具，才值得继续研究。

后面如果你需要在多个模型之间切换，再把 cc-switch 接进来。

以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧。

如果想第一时间收到后续教程，也可以给我一个星标。

谢谢你看我的文章

晴时有记，阴时不更

我是晴天，我们下次再见。