引言
许多顶级AI代理（如Claude Code和ChatGPT）给用户带来三个常见问题：
- 使用门槛高——在国内访问它们并不容易
- 等待时间长——热门平台的试用通道排队漫长
- 缺乏隐私——代码和数据由第三方控制
OpenCode通过三大优势解决了这些问题：
- 开源，197K+ GitHub星标，确保代码透明
- 友好的桌面版，国内可直接使用
- 内置免费模型，开箱即用
本指南将带你完成安装和基本使用。
安装
- 访问OpenCode官方下载页面
- 选择与你的操作系统兼容的版本
- 下载并安装应用程序
系统要求：
- 办公任务或小型个人项目，普通家用电脑或轻量笔记本即可
开始使用
1. 模型选择
选择正确的模型至关重要：
- 免费模型：查找名称中标注"Free"的模型（如DeepSeek V4 Flash）
- 模型详情：将鼠标悬停在模型名称上查看其能力
- 多模态支持：只有MIMO模型支持文本之外还可处理图片、音频和视频
2. 工作模式选择
OpenCode提供两种主要工作模式：
- Build模式：默认执行模式，具备完整的文件读写和命令执行能力
- Plan模式：分析和规划模式，只生成方案，不修改文件也不运行命令
何时使用Plan模式：
- 想法还不清晰，需要理清思路时
- 扩展已有项目时
- 不确定实现细节时
3. 添加工作文件夹
OpenCode围绕项目文件夹工作：
- 已有项目：选择你的现有项目文件夹
- 新项目：创建一个英文名称的新文件夹（如
test），避免中文路径可能导致的错误
常用命令
OpenCode提供三个基本命令：
@命令
@[file_path]- 把项目文件夹中的特定文件或目录添加为上下文
- 适合引用现有代码或文档
/命令
/[command_name]- 快速执行内置或自定义命令
- 常见操作以一键按钮形式提供
Shell命令
![shell_command]- 直接在聊天窗口中运行终端命令
- 高级用户可借此进行系统级操作
免费模型使用规则
- 无固定免费额度：官方文档未指定固定上限
- 额度用尽：免费额度用完后，会看到"free usage exceeded"提示
- 重置时间：额度重置的倒计时各不相同（有的约5小时，有的可达10小时以上）
- 重度使用：建议接入自己的API Key以获得稳定访问
配置自定义模型
要使用你自己的API Key：
- 打开模型选择窗口
- 滚动到底部，点击"View more providers"
- 从列表中选择你的供应商
- 在配置面板中输入你的API Key
结语
OpenCode为传统AI编程助手提供了一个强大而友好的替代方案。凭借其开源特性、国内可用性和内置免费模型，无论新手还是经验丰富的开发者，它都是绝佳选择。先从免费模型入手熟悉界面，再逐步探索高级功能。
常见问题
OpenCode Desktop真的免费吗？
是的。OpenCode本身以MIT协议开源，并内置开箱即用的免费模型。官方没有设定固定免费额度——免费用量用尽时会看到"free usage exceeded"提示，额度按倒计时重置，时长从约5小时到10小时以上不等。如果每天重度使用，接入自己的API Key可以获得更稳定的访问。
Build模式和Plan模式有什么区别？
Build模式是默认执行模式：代理对文件有完整的读写权限，并能运行命令。Plan模式只做分析——它生成方案和计划，但不修改任何文件也不执行命令。当你想法还不清晰需要理清思路、要扩展已有项目，或不确定实现细节想先探索再动手时，就用Plan模式。
为什么OpenCode内置DeepSeek V4 Flash？
DeepSeek V4 Flash是OpenCode内置的免费模型之一，所以你可以不花一分钱、不配置任何东西就立即开始编码。OpenCode模型无关，支持75+供应商，内置免费模型只是起点——你还可以从模型选择窗口的"View more providers"接入Anthropic、OpenAI、Gemini、本地Ollama模型，或你自己的API Key。
我可以在OpenCode里使用自己的API Key吗？
可以。打开模型选择窗口，滚动到底部，点击"View more providers"。从列表中选择你的供应商，在配置面板中输入API Key。这是重度生产使用的推荐方式，因为内置免费模型可能触达额度上限，且重置时间不固定。