OpenCode 喂饭教程(上):安装与 DeepSeek 模型接入实测

OpenCode 喂饭教程(上):一行命令装好,接上 DeepSeek 就能跑

AI 编程工具这两年卷得厉害。Cursor、Claude Code、Codex 这些名字天天在你眼前晃,但真要上手——魔法上网、绑信用卡、不支持国产模型——门槛卡掉了一大批人。
OpenCode 这个开源工具就是给这批人准备的。不绑定任何模型厂商,原生支持智谱、DeepSeek、通义这些国产 API,国内直连就能用。这套教程分上中下三篇,上篇讲安装和接通第一个模型。

OpenCode 与主流 AI 编程工具的定位关系
OpenCode 与主流 AI 编程工具的定位关系

先认清门派:IDE 派 vs TUI 派

AI 编程工具大致分两派,搞清楚自己适合哪派再选。

IDE 派——代表是 Cursor、Windsurf、GitHub Copilot、Trae 这类。图形界面,所见即所得,AI 当你的副驾驶,你还是主要操作者,盯着屏幕边看边改。适合习惯 IDE、需要视觉反馈的人。

TUI 派(终端界面工具)——代表是 Claude Code、Codex CLI、OpenCode。终端原生,轻量快速,AI 是主要执行者,你是指挥官。能开多个任务并行不用盯着屏幕,可编程、可自动化、可嵌进 CI/CD。适合玩 Vibe Coding、习惯终端、要做自动化的场景。

OpenCode 属于 TUI 派。

TUI 三选一:OpenCode 的位置

TUI 这条赛道目前主要有三个选项。我把它们摆一起比一下你就明白 OpenCode 凭什么有位置。

Claude Code(Anthropic 官方):体验完善,支持 VS Code 和 JetBrains 插件。但绑定 Claude 模型,不支持国产模型,国内访问不便。月费 $20 起。

Codex CLI(OpenAI 官方):云端异步执行,能并行多任务自动跑测试。但绑定 GPT 系列,不支持国产模型,国内访问同样不便。月费 $20 起。

OpenCode(社区开源):75+ 模型自由切换,免费(配合智谱 GLM 包月 ¥20 起等国产套餐)。数据隐私直连 API 或本地、开源、模型自由、原生支持智谱 DeepSeek 通义 MiniMax、中文完善、跨平台 macOS/Linux/Windows。

看出门道了吗?前两个是"官方出品但绑死自家模型",OpenCode 是"不绑、开源、国产友好"。对国内开发者来说,这点差异决定了你能不能用得舒服。

TUI 三家对比:Claude Code _ Codex CLI _ OpenCode
TUI 三家对比:Claude Code _ Codex CLI _ OpenCode

一行命令装上 OpenCode

OpenCode 本身安装不难,一行命令搞定。真正卡小白的是装完到能用之间那一段。

官方给了几种装法,挑顺手的用。

macOS / Linux 用户:终端粘贴这行,回车——

curl -fsSL https://opencode.ai/install | bash

看到 Installation complete! 就成了。Mac 用户我建议直接走这条,复制粘贴的事。

Windows 用户:推荐用 Scoop(不需要管理员权限)——

scoop install opencode

或者用 npm(需要 Node.js 18+)——

npm install -g opencode-ai

验证安装:终端敲——

opencode --version

能看到版本号就说明装进来了。版本号会随更新变化,只要正常显示就 OK。

command not found:小白第一坑

装完直接在原来那个终端窗口敲 opencode,不少人这一步就懵了——蹦出来一行:

command not found: opencode

到这一步很多人会以为是装失败了,开始反复重装、到处翻教程。其实没失败。

curl 那个脚本已经把 opencode 写进了系统路径,但你当前这个终端窗口是装之前就开着的,它还没重新读取配置,所以暂时找不到。

解决很简单,二选一:

  1. 关掉当前终端,重新开一个新窗口,再敲一次 opencode -v
  1. 或者不关窗口,执行一下 source ~/.zshrc(Mac 现在默认是 zsh),让它重新加载配置

command not found 在这里不是装错了,是终端没刷新——这点分清楚,能少走很多弯路。

还有一种情况是安装时卡在网络。脚本要联网拉东西,网络抖动会卡很久。这时候重新刷一下网络、换条线再试。或者干脆去 GitHub 仓库直接下安装包,解压手动装。

启动与免费模型体验

终端里敲 opencode 直接启动。

启动后输入 /models,选一个带 -free 后缀的免费模型(比如 opencode/glm-4.7-free),然后发送任意消息就能对话。

免费模型无需注册账号、无需 API key,适合先体验一下界面和操作手感。觉得顺手了,再花时间接正式的付费模型。

补一句终端的事——OpenCode 跑在终端里,界面是字符画出来的那种。Mac 自带的 Terminal.app 渲染这种界面有时候会错位、配色发乱,建议换 iTerm2、Ghostty 这类现代终端。我自己全程用 iTerm2,体验会好很多。

OpenCode 终端 TUI 界面与免费模型列表
OpenCode 终端 TUI 界面与免费模型列表

接入 DeepSeek V4 Pro 全流程

opencode 装好了,但它现在还是个空壳——你还没给它接模型。opencode 不绑定某一家模型,用哪个由你定。这篇我接的是 DeepSeek V4 Pro,国内直连、价格便宜、能力够用。

第一步:拿 API key

打开 DeepSeek 的开放平台 API key 页面(platform.deepseek.com/api_keys),登录后点「创建 API key」,给它起个名字(比如就叫 opencode,方便以后认出这把 key 是给谁的),确认。

弹出来的那串以 sk- 开头的就是你的 key,当场就复制存好。

这里有个坑:完整的 key 一般只在创建那一下显示,关掉弹窗,列表里就只剩打码的尾号了。回头找不到完整 key 只能重新创建一把。

DeepSeek API 是按用量付费的。我自己充了 50 块钱,用了很久。前段时间还有优惠活动,价格非常友好,能力也不差,这也是我选它做演示的原因。

如果你有 GPT 或 Claude 的 key 也能接——GPT 走网页授权登录就行,Claude 需要走第三方 API 服务(官方接口不支持)。

第二步:把 key 接进 OpenCode

回到终端启动 opencode,进去后输入 /connect。

opencode 会让你选 provider(模型来源),输入 deepseek,把列表里的 DeepSeek 选中。接着弹出一个输入框让你填 API key——把刚才那串 sk- 开头的 key 粘进去,回车。

第三步:选模型

key 接上之后,再输入 /models,opencode 会列出当前能用的所有模型。在列表里找到 DeepSeek V4 Pro,选中它。

到这里,opencode 就已经在用 DeepSeek V4 Pro 了。

验证接通与常见报错排查

配是配好了,但口说无凭,发条消息让它自己说。

我直接问了一句「你是什么模型」,它回的是「我是 DeepSeek-V4-Pro。」opencode 界面底部的状态栏也明明白白写着当前模型是 DeepSeek V4 Pro。

模型自己报的名字、状态栏显示的名字,两个对上了,就说明 DeepSeek V4 Pro 真的接通了,不是还在用别的默认模型。

对话验证:模型自报身份与状态栏对上号
对话验证:模型自报身份与状态栏对上号

要是没接通,一般卡在这几个地方,对着排查:

  • /connect 里搜不到 deepseek:多半是 opencode 版本太老,回去升级到最新版
  • 发消息报 401:API key 不对,或者粘的时候少了几位,回 DeepSeek 官网重新复制一遍
  • 报余额不足、模型不存在:回 DeepSeek 账户看一眼余额,再确认模型选的是不是 V4 Pro

我自己测试了几下还是非常快的,最主要的是不需要解决网络问题——国内直接就能稳定用上,这点对国内开发者太关键了。

只要一步一步走下来,你一定能跟我一样把 OpenCode 装上、把模型接通,其实没什么难度,最主要的是自己细心。这一篇的目的就是教小白装好、配好第一把模型。

下篇我会讲 OpenCode 的 skill 安装和使用——把它优化到可以和官方那些 TUI 工具一样好用。感兴趣的话,关注后续更新。

本文网址:https://blog.520zyw.com/41.html
转载请声明来自:伍零博客 - OpenCode 喂饭教程(上):安装与 DeepSeek 模型接入实测


使用声明:

1、本站所有素材,仅限学习交流,请勿用于商业用途。

2、本站资源大多无解压密码,如遇需要解压密码,无特殊说明,均为:伍零博客

3、下载积分可通过日常 签到、绑定邮箱 等途径免费获得!

4、本站提供的源码、模板、软件工具等其他资源,均不包含技术服务,请大家谅解!由于资源大多存储在云盘,如出现链接失效请评论反馈。

5、如果素材损害你的权益,请 联系我们 给予处理。