OpenCode（当前活跃项目：github.com/anomalyco/opencode）是一款开源、终端优先、模型无关的 AI 编程智能体（Coding Agent），旨在让开发者在不离开终端/命令行环境的前提下，高效完成代码生成、理解、调试与重构等任务。

一、核心定位与背景

• 开发者：Anomaly (anomalyco) 团队
• 首次发布：2024年底
• 开源协议：MIT License（完全免费、可自由修改）
• 核心口号：Terminal First, Multi-Model, Privacy-Secure（终端优先、多模型、隐私安全）
• 与传统工具区别：
  • 不是 IDE 插件：独立运行，原生终端体验
  • 不是 AI 模型：是模型调度层，连接你选择的 LLM
  • 不是简单补全：具备自主规划、文件读写、命令执行的 Agent 能力

二、核心功能与特性

1. 多模型支持（75+ 提供商）

   • 云端：OpenAI GPT-4o, Anthropic Claude 3, Google Gemini, Groq 等
   • 本地：Llama 3, Qwen, DeepSeek (通过 Ollama 等)
   • 自由切换：不绑定任何厂商，只按你选择的模型 API 计费

2. 终端原生（TUI）体验

   • 美观流畅的终端用户界面（基于 Go + Bubble Tea）
   • 无需浏览器、无需登录、轻量快速
   • 支持自定义主题、快捷键、工作流

3. 强大的 AI 代理（Agent）能力

   • Build Agent（默认）：读写文件、生成/修改代码、执行命令
   • Plan Agent：只读分析、项目规划、生成开发路线图
   • Debug Agent：自动定位 Bug、分析报错、给出修复方案

4. 隐私优先

   • 默认不上传代码：所有数据仅在本地与你选择的 LLM 间传输
   • 支持完全离线：对接本地模型时，代码永不出本地环境
   • 不收集用户数据

5. 全平台与多端支持

   • 系统：macOS / Windows / Linux
   • 形态：
     • CLI / TUI（核心）
     • 桌面应用（Beta，Electron + Rust）
     • IDE 扩展（VS Code 等）

6. 开发工具链集成

   • 原生支持 LSP（语言服务器协议），深度理解代码语法与结构
   • 多会话并行、会话分享链接、Git 集成、Docker 隔离

三、与主流工具对比

特性	OpenCode	GitHub Copilot	Claude Code
开源	✅ 完全开源 (MIT)	❌ 闭源	❌ 闭源
费用	✅ 工具免费 (仅API费)	❌ 订阅 ($10/月)	❌ 订阅 ($20/月)
模型绑定	✅ 75+ 模型自由切换	❌ 仅限 OpenAI 模型	❌ 仅限 Claude 模型
终端原生	✅ 专为终端设计	❌ IDE 插件为主	⚠️ 终端支持有限
本地离线	✅ 完美支持	❌ 不支持	❌ 不支持
隐私	✅ 代码本地处理	⚠️ 代码上传微软	⚠️ 代码上传 Anthropic

四、安装与使用（极简）

# macOS / Linux (Homebrew)
brew install opencode-ai/tap/opencode

# Windows / npm
npm install -g opencode

# 启动
opencode

• 首次启动配置 API Key（如 OpenAI, Anthropic）
• 输入自然语言指令：帮我写一个Python爬虫、修复这个bug、重构这个项目

五、总结

OpenCode 是当前最热门的开源 AI 编程智能体，它将强大的代码生成能力无缝融入开发者最熟悉的终端环境，彻底摆脱厂商锁定与隐私顾虑。如果你追求自由、高效、安全的 AI 辅助开发体验，OpenCode 是首选工具。

---

下面给你一套最精简、直接能用的 OpenCode 配置 + 常用指令清单，照着复制粘贴就能跑起来。

---

一、先安装（任选一种）

1. macOS / Linux

brew install opencode-ai/tap/opencode

2. Windows / 通用（npm）

npm install -g opencode

3. 验证安装

opencode --version

---

二、快速配置（首次必做）

直接启动进入配置向导：

opencode

关键配置步骤

1. 选择你要用的模型：
   • 推荐：openai / anthropic / groq / ollama（本地）
2. 填入 API Key
3. 设置默认模型（如 gpt-4o）
4. 是否允许执行命令：建议选 yes

配置文件会存在：

~/.opencode/config.json

---

三、最常用命令清单（直接抄）

1. 基础使用

# 进入交互模式
opencode

# 直接一句话任务
opencode "帮我写一个Python快速排序"

# 分析当前项目结构
opencode "分析这个项目，给出技术栈和改进建议"

2. 文件操作

# 查看文件
opencode "查看 main.py"

# 修改文件
opencode "修复 main.py 第20行的bug"

# 新建文件
opencode "创建一个Vue3组件，带Element Plus表单"

3. 运行与调试

# 运行并解释报错
opencode "运行 npm run dev，解释错误并修复"

# 调试
opencode "debug 这个Python脚本"

4. 项目重构/规划

# 生成项目计划
opencode "为我规划一个博客后端项目结构"

# 重构代码
opencode "重构 index.js，提高可读性和性能"

5. 离线本地模型（Ollama）

# 先装ollama
ollama run qwen2.5-coder

# opencode 切换到本地模型
opencode --model ollama/qwen2.5-coder

---

四、实用小技巧

• 输入 exit 退出交互
• 输入 clear 清屏
• 支持直接粘贴报错日志，它会自动分析
• 想更安全：配置时关闭自动执行命令权限

---

五、你告诉我两点，我可以给你定制配置

1. 你用 Windows / Mac / Linux？
2. 你打算用 GPT-4o / Claude / 本地模型 哪个？

一键可用的 config.json ，粘贴就能用。

好，那我直接给你一套Windows + 本地模型（Ollama）的完整流程，全程不用 API Key、不用联网、代码完全在本地跑。

---

一、先装本地模型引擎：Ollama（必须）

OpenCode 本地推理靠 Ollama 运行模型。

1. 去官网下载 Windows 版：
   https://ollama.com/download/windows
2. 安装，一路下一步即可。
3. 安装完打开 PowerShell 或 CMD，输入：

print("ollama run qwen2.5-coder:8b")

ollama run qwen2.5-coder:8b

ollama run qwen2.5-coder:8b

它会自动下载模型，等待下载完成。

推荐模型：

• qwen2.5-coder:8b 速度快、写代码很强
• deepseek-coder-v2:8b 也非常强

---

二、安装 OpenCode（Windows）

打开 PowerShell（管理员最好），运行：

print("npm install -g opencode")

npm install -g opencode

npm install -g opencode

如果没装 npm，先装 Node.js：
https://nodejs.org/ 下载 Windows 安装包。

---

三、让 OpenCode 连接本地模型（关键配置）

直接在终端输入：

print("opencode config set provider ollama")
print("opencode config set model qwen2.5-coder:8b")

opencode config set provider ollama
opencode config set model qwen2.5-coder:8b

opencode config set provider ollama
opencode config set model qwen2.5-coder:8b

这样就完全本地了，不会走任何云端 API。

---

四、直接启动本地编程助手

opencode

进入后直接说：

• 写一个 Python 爬虫
• 帮我写一个登录接口
• 解释这段代码
• 修复这个 bug
• 生成一个 Vue3 组件

它会在本地推理，不会上传代码。

---

五、Windows 常用命令（直接复制）

# 一句话任务
opencode "写一个Python批量重命名文件脚本"

# 分析当前文件夹项目
opencode "分析项目结构"

# 查看并修改文件
opencode "查看 main.py 并优化"

# 调试报错
opencode "运行 app.py 并修复错误"

---

六、安全与隐私（非常重要）

• 代码完全不出电脑
• 不需要 OpenAI Key
• 不会收集数据
• 推理速度取决于你的电脑配置（8G 内存以上流畅）

---

如果告诉我你的电脑配置（CPU / 内存 / 有没有显卡），我可以给你挑最适合你机器的本地模型，让速度更快、代码更强。

按你这个配置：i5 + 16G 内存 + 无独显，完全可以跑本地代码大模型，我给你一套最稳、最快、不卡机的专用方案。
一、适合你的本地模型推荐
只用 4B 量化版，别用 8B，不然会卡顿。
qwen2.5-coder:4b-q4_0
deepseek-coder-v2:4b-q4_0
这两个在 16G 内存 i5 上流畅运行，写代码、改 Bug、解释逻辑都够用。

二、一键安装本地模型（Ollama）
打开 PowerShell 直接复制运行：
bash
运行
ollama pull qwen2.5-coder:4b-q4_0
等待下载完成即可。
三、OpenCode 绑定本地模型（关键）
bash
运行
opencode config set provider ollama
opencode config set model qwen2.5-coder:4b-q4_0
四、启动本地 AI 编程助手
bash
运行
opencode
现在你就拥有了：
完全本地
不联网
不上传代码
不收费
i5 16G 流畅运行
的 AI 编程助手。
五、你可以直接这样用
帮我写一个 Python 批量重命名文件
解释这段代码
帮我写一个登录接口
修复这个报错
生成一个 Vue3 组件
六、小优化（让速度更快）
关闭浏览器、微信等占内存软件
模型只选 4B，不要用 8B
不要同时开多个 Ollama 模型