1. 什么是 OpenCode

OpenCode 是一个开源的 AI 编程代理，运行在终端里。

它本质上是一个 TUI（终端用户界面）程序——装完在终端敲 opencode 进入对话界面，直接用自然语言描述需求，AI 就会帮你写代码、改代码、跑命令。全程不需要鼠标。

技术层面：Go 语言构建，基于 Bubble Tea 框架的 TUI，SQLite 持久化存储。

核心特性：

• 开源免费，MIT 协议
• 支持 75+ 模型提供商
• 自带免费模型（Zen），零成本上手
• 支持 MCP 协议、多会话管理、LSP 集成
• 有桌面客户端可选（Windows/macOS/Linux）

2. 和主流 Coding Agent 有啥差别

对比项	OpenCode	Cursor	Windsurf	Claude Code
形态	终端 TUI	IDE 插件	IDE 插件	终端 CLI
操作方式	全键盘	鼠标+键盘	鼠标+键盘	全键盘
费用	免费开源	订阅制	订阅制	订阅制
模型	自带免费 / 自配	内置模型	内置模型	仅 Claude
国产模型	支持（GLM/DeepSeek/Qwen等）	不支持	不支持	不支持
本地模型	Ollama 支持	有限	有限	不支持

一句话总结：

OpenCode 是纯终端派的 Claude Code 开源平替，对国产模型和本地模型友好，零成本上手。 如果你习惯在终端里干活、不想被绑定在某个 IDE 上、想用自己的模型（尤其是国产模型或本地模型），OpenCode 是目前最合适的选择。

3. 安装

方式一：一键安装（推荐）

全平台通用：

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

装完验证：

opencode --version

方式二：npm 安装

有 Node.js 环境的可以用：

npm install -g opencode-ai

注意：Windows 用户建议以管理员身份运行终端。网络慢的话先切国内镜像源。

4. 配置模型

装完别急着写代码，先让 OpenCode 连上一个模型。

Step 1：启动

cd 你的项目目录
opencode

Step 2：连接模型

进入 TUI 后，敲 /models：

/models

在 /models 列表中选择 Free 模型，回车即用，无需 API Key。
LLM模型免费，现在是 “0元购”
按方向键选择模型提供商，回车确认。

或者 进入 TUI 后，敲 /connect：

/connect

🔥 推荐方案

方案 A：用 DeepSeek（性价比之选）

1. 去 https://platform.deepseek.com 注册，充 10 块钱能用很久
2. /connect → 选 DeepSeek → 粘贴 API Key
3. 选 deepseek-chat 模型

5. Hello World

模型配好后，直接上手跑第一个任务。

在 OpenCode 的 TUI 中输入：

在当前目录创建一个 Python 文件 hello.py，打印 "Hello OpenCode"

AI 会依次执行：

1. 创建 hello.py 文件
2. 写入 print 代码
3. 运行验证

你会实时看到每一步的执行过程和输出。

6. 几个主要命令

/init — 初始化项目

/init

让 AI 了解当前项目结构，生成 .opencode/ 和 AGENTS.md。

/models — 切换模型

/models

列出所有可用模型，按方向键切换。

/new — 新建会话

/new

新开一个会话，从头开始聊。

/sessions — 选择/继续历史会话

/sessions

列出所有历史会话，按方向键选中后回车，继续之前未完成的任务。
临时退出的对话，可以通过这种方式继续

/undo — 撤销

/undo

撤销上一步操作（需要项目已经是一个 Git 仓库）。

/help — 帮助

/help

或按 ?，弹出帮助弹窗。

7. 模式切换

OpenCode 有两种模式Plan和Build

模式对比：

模式	适用场景
Plan	计划 / 分析模式
Build	构建 / 修改模式

Tab 切换模式

8. 退出

按 Ctrl+C 退出 OpenCode。

或者在 TUI 中输入：

/exit

也支持 /quit 或 /q。

---

到这里你已经可以正常使用 OpenCode 了。上手路径建议：

安装 → 连免费模型 → Hello World → 日常编码熟悉 → 进阶 MCP/自定义命令