---

---

前言

在 AI 编程助手快速发展的今天，OpenCode 凭借其免费开源、模型自由、三端可用的特点，成为个人零成本体验 AI 编程能力的理想选择。本文将从零开始，手把手带你完成 OpenCode 的安装、配置与上手使用。

无论你是刚接触 AI 编程的新手，还是想寻找免费替代方案的老手，本文都能帮你快速跑通全流程。全文共分五个部分：先介绍为什么选择 OpenCode，再完成 Node.js 环境与 DeepSeek API Key 的准备，接着分别讲解桌面版与命令行版的安装，然后配置免费模型或接入 DeepSeek API，最后附上常用命令速查表与模型对比，方便日常查阅。

建议按顺序阅读，跟着每一步操作即可。遇到问题欢迎在评论区留言交流。

1. 为什么选OpenCode?

一句话概括：OpenCode是一款免费开源的AI编程助手，支持终端、桌面和IDE三种使用方式，可接入包括DeepSeek在内的75+种AI模型，是个人零成本体验AI能力的理想起点。

OpenCode的三个核心优势：

优势	说明
完全免费	开源软件，无需任何订阅费用，可直接下载使用
模型自由	支持 DeepSeek、Claude、GPT、Gemini 等 75+ 家模型提供商，可自由切换
三端可用	桌面版（适合新手）、命令行版（适合进阶）、VS Code 插件（适合开发者）

2. 安装前的准备工作

OpenCode运行需要Node.js环境（版本18及以上）。务必按以下步骤完成准备：

2.1 安装Node.js

1. 访问Node.js官网（nodejs.org）
2. 下载Windows安装程序（.msi）
   
3. 双击安装，一路点击Next完成安装
4. 验证安装：按Win+R输入cmd，在命令窗中输入：

node -v

若能正常显示版本号（如 v18.x.x），则安装成功。

2.2 注册DeepSeek API Key

1. 访问DeepSeek开放平台（platform.deepseek.com）
2. 注册账号并登录
3. 进入API Key管理页面，点击创建API Key
4. 复制并妥善保存生成的API Key（格式类似 sk-xxxxxxxx）
   
   

2.3 API Key到底是什么？

API Key是一把“独立门禁卡”——每张卡都能打开DeepSeek这栋楼的门，但每张卡都可以设置不同的权限（比如限制用量、指定可用的模型），而且每张卡都能独立统计“刷开过几次门”、花了多少钱。

更通俗地理解：
你注册DeepSeek账号，相当于办理了这栋楼的业主身份。然后你可以去物业处申领多张门禁卡（API Key）：

场景	对应说明
A卡 发给 OpenCode 用	A卡刷了100次门，统计清楚
B卡 发给 Claude Code 用	B卡刷了50次门，独立记录
C卡 临时开给同事测试用	用完可以随时注销，不影响A卡和B卡

所以API Key的本质是：

• 可创建多个：一个账号可以生成多个Key，分别用于不同工具或不同项目
• 可独立管理：每个Key都可以单独命名、单独设置用量上限、单独查看消费记录
• 可随时撤销：某个Key泄露了，只需要删掉那一个，其他Key完全不受影响
• 不是密码：它不能登录你的DeepSeek账号，不能修改你的账户信息，只能用来调用AI能力

API Key就是你的“钱包钥匙”，千万不要截图发到群里或分享给任何人！ 一旦泄露，他人可随意消耗你的 API 额度，造成不必要的费用损失。如果不慎泄露也无需慌张——登录 DeepSeek 开放平台，在 API Key 管理页面删除该 Key 并重新生成即可，其他 Key 完全不受影响。曾有用户把 Key 截图发到工作群，结果当天就被他人调用消耗了数十元额度，务必引以为戒。

3. 安装OpenCode

OpenCode提供桌面版和命令行版两种形式。强烈推荐个人选择命令行版，桌面版和DeepSeek客户端等差不多，可以自行体验。本次分享主要是想引导个人深度使用AI提效，所以选择灵活度更高的命令行版。

3.1 桌面版安装

Windows系统：

1. 访问OpenCode官网（opencode.ai），点击下载桌面版
2. 下载得到 opencode-desktop-windows-x64.exe 安装文件（约120M）
3. 双击运行exe文件，等待自动安装完成（约10秒）
4. 安装完成后，桌面会出现OpenCode快捷图标，程序自动弹出

macOS系统：

1. 根据芯片类型选择对应安装包：Apple Silicon选 aarch64.dmg，Intel选 x64.dmg
2. 双击dmg文件，将OpenCode图标拖入"应用程序"文件夹
3. 在启动台中找到OpenCode并打开

3.2 命令行版

3.2.1 通过npm全局安装

npm install -g opencode-ai@latest

参数说明：-g 表示全局安装，安装后可以在任何目录下直接使用 opencode 命令。

3.2.2 验证安装是否成功

安装完成后，输入以下命令验证：

opencode --version

若能正常显示版本号（如 v1.14.24 及以上），说明安装成功。

3.2.3 首次启动

输入以下命令启动OpenCode：

opencode

首次启动时，OpenCode会自动进行初始化配置，包括创建配置文件和必要的依赖安装。整个过程约需1-2分钟，请耐心等待。
启动成功后，你会看到OpenCode的全屏交互界面（TUI），类似下图：

此时OpenCode还没有配置任何AI模型，需要先接入DeepSeek。

4. 配置模型

4.1 免费（每日限额）

OpenCode本身是一个免费开源的工具，不内置任何AI模型，也不直接提供免费额度。但它已经预集成了超过75家模型提供商，其中不少提供商（如DeepSeek、Groq、Google Gemini等）都面向新用户提供了每日免费额度或初始赠送额度。
你只需在OpenCode的模型列表中，选择右侧带有 Free 标签的模型，即可直接使用这些免费额度开始体验，无需绑定信用卡或预先付费。这对于刚入门、想先试试AI能做什么的销售同事来说，是非常友好的零成本上手方式。

1. 打开模型选择面板，在OpenCode的TUI界面中，输入 /models 然后按回车，或者使用快捷键 Ctrl+M（Windows/Linux）或 Cmd+M（Mac）。
   
2. 请选择右侧带有 Free 标签的模型。这类模型每日享有免费调用额度，适合日常体验与功能验证。
3. 验证是否接入成功
   

4.2 接入DeepSeek API

1. 打开模型选择面板，在OpenCode的TUI界面中，输入 /connect 然后按回车。
   
2. 输入指定的AI供应商，比如deepseek，然后按回车。
   
3. 接下来，你需要输入 DeepSeek 的 API Key。可以从 DeepSeek 开放平台 申请并获取你的专属 Key。

4. 支持的模型列表中选择模型，即可完成配置。

5. 在DeepSeek网站充值后，即可进行具体提问设置。

5. 附录

附录A：常用命令速查表

命令	功能
opencode	启动 OpenCode
/model	查看/切换当前模型
/new	开启新会话
/help	查看所有可用命令
/files	查看当前目录文件列表
Ctrl+C	退出 OpenCode

附录B：deepseek模型对比

模型	参数规模	上下文长度	推荐场景
deepseek-v4-pro	1.6T	1M	主力模型，适合复杂任务
deepseek-v4-flash	—	—	轻量任务，响应更快
deepseek-v4-flash-vision-exp	—	—	涉及图片理解的任务

---

结语

本文从零开始，带你完成了 OpenCode 的安装、配置与上手使用：先了解了它免费开源、模型自由、三端可用的核心优势，再完成 Node.js 环境与 DeepSeek API Key 的准备，接着分别体验了桌面版与命令行版的安装，最后配置了免费模型或接入 DeepSeek API，并附上常用命令速查表与模型对比，方便日常查阅。

如果你在安装或配置过程中遇到问题，欢迎在评论区留言交流，我会尽力帮你解答。也欢迎点赞、收藏本文，方便日后需要时快速查阅。💌

---