本文由天津医科大学佳泽铭玉小组整理，适合初学者上手，内容可直接实践。

---

一、什么是 OpenCode？

OpenCode 是由 SST 团队开发的开源、终端原生 AI 编程助手，基于 TUI（终端用户界面）运行，无需浏览器或 IDE 插件，直接在命令行中调用大语言模型辅助编写、修改、解释代码。

• GitHub 仓库：https://github.com/sst/opencode
• 官方网站：https://opencode.ai
• 开源协议：MIT（完全免费）

---

二、核心亮点

特性	说明
🆓 完全免费开源	MIT 协议，无订阅费用
🤖 支持 70+ 模型	OpenAI、Claude、Gemini、Ollama 本地模型等
💻 纯终端运行	不依赖 IDE，任意环境可用
🔌 多 Provider 支持	自带 API Key 即可接入主流大模型
📁 上下文感知	自动读取当前项目文件结构

支持的模型 Provider 包括：

• OpenAI（GPT-4o、GPT-4.1 等）
• Anthropic Claude（Claude 3.5/3.7 Sonnet 等）
• Google Gemini
• AWS Bedrock
• Ollama（完全本地，无需联网）
• Mistral、Groq、Perplexity 等

---

三、OpenCode VS 商业编程工具

对比项	OpenCode	Cursor / Copilot
费用	免费（需自备 API Key）	付费订阅（$10~$20/月）
运行环境	终端 TUI	IDE 插件/独立客户端
模型选择	70+ 自由切换	受限于平台提供的模型
隐私性	数据直连模型 API	经过平台中转
上手难度	稍高（需配置 API Key）	较低

---

四、安装部署

4.1 前提：安装 Node.js

OpenCode 基于 Node.js 运行，需要 Node.js v18 及以上版本。

官方下载地址：https://nodejs.org/en/download

推荐使用 fnm（快速 Node 版本管理器）安装：

Windows（PowerShell）：

winget install Schniz.fnm
fnm install --lts
fnm use lts-latest
node -v

---

Windows（PowerShell）：

brew install fnm
fnm install --lts
fnm use lts-latest
node -v

---

Windows（PowerShell）：

curl -fsSL https://fnm.rs/i | bash
source ~/.bashrc   # 或 source ~/.zshrc
fnm install --lts
node -v

---

4.2 安装 OpenCode

Node.js 安装完成后，执行以下命令安装 OpenCode：

# 全局安装（推荐）
npm install -g opencode-ai

# 或者使用 npx 直接运行（无需全局安装）
npx opencode-ai

验证安装：

opencode --version

---

4.3 Windows 额外配置（PowerShell 执行策略）

如果 Windows 上遇到脚本无法执行的问题，需要先开放执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

---

五、配置 API Key（以 OpenAI 为例）

5.1 获取 OpenAI API Key

1. 访问 https://platform.openai.com/api-keys
2. 登录账号（需注册 OpenAI 账号）
3. 点击 “Create new secret key”
4. 复制生成的 Key（格式：sk-...），请妥善保存，只展示一次

⚠️ 注意：OpenAI API 按 Token 用量计费，建议在 Billing 页面设置用量上限，避免超支。

5.2 在 OpenCode 中配置

首次运行 opencode 时会引导配置，或手动编辑配置文件：

opencode

按提示选择 Provider（如 OpenAI），输入 API Key 即可开始使用。

配置文件默认保存在：

• Linux/macOS：~/.config/opencode/config.json
• Windows：%APPDATA%\opencode\config.json

---

六、基本使用

在任意项目目录下运行：

cd your-project
opencode

常用快捷键：

快捷键	功能
Ctrl+C	退出
Tab	切换面板
Enter	发送消息
/	输入斜杠命令

常用指令示例：

# 让 AI 解释代码
解释一下这个函数的作用

# 让 AI 修复 bug
帮我修复这个报错：[粘贴错误信息]

# 生成代码
用 Python 写一个读取 CSV 文件并统计行数的脚本

---

七、结语

OpenCode 是目前最适合学生和开发者自主部署的 AI 编程工具之一。相比订阅制的 Cursor，它的优势在于完全透明、自主可控、支持本地模型（Ollama），特别适合：

• 预算有限的学生党
• 对数据隐私有要求的场景
• 希望深度定制 AI 工作流的开发者

项目地址：https://github.com/sst/opencode ⭐ 欢迎 Star

---

本文由天津医科大学医学影像学 佳泽铭玉小组 出品
如有疑问欢迎评论区交流 🙌
``