夜雨聆风2026年6月，OpenCode登顶LogRocket《AI Dev Tool Power Rankings》第一，成为GitHub上星标数最高的开源AI编程工具。
160K+ Stars、750万月活、75+模型支持——这个终端原生的开源AI Coding Agent，正在改变开发者的工作方式。
如果你还没用过OpenCode，或者还在Cursor和Claude Code之间犹豫，这篇文章会带你从零开始，一步步掌握这个2026年最值得学习的开源AI编程工具。
OpenCode是什么？
OpenCode是一个终端原生的开源AI编程代理，由Anomaly团队开发，采用MIT许可证，源代码完全公开。
它不是一个简单的代码补全工具，而是一个能理解整个项目、直接修改代码、执行终端命令的AI编程助手。你可以在命令行里和它对话，让它帮你写代码、重构项目、调试bug、生成测试用例。
核心特点：
•开源免费：MIT协议，无商业锁定
•模型无关：支持75+模型，包括Claude、GPT、DeepSeek、GLM、Qwen、Kimi等
•CLI原生：终端工作流，无需切换到IDE
•高度可定制：支持自定义Agent、命令、快捷键、主题
安装与配置
环境要求
•Node.js：v18.0.0 或更高
•Git：用于代码管理
•终端：WezTerm、Alacritty、Ghostty、Kitty等现代终端推荐
macOS安装
•推荐方式：官方一键安装
curl -fsSL https://opencode.ai/install | bash
•Homebrew方式
brew install anomalyco/tap/opencode
•验证安装
opencode --version
Windows安装
Windows用户强烈推荐使用WSL（Windows Subsystem for Linux），因为WSL更稳定且完整支持所有功能。
curl -fsSL https://opencode.ai/install | bash
Linux安装
•Debian/Ubuntu：curl -fsSL https://opencode.ai/install | bash
•Arch Linux：paru -S opencode-bin
•Docker：docker run -it --rm ghcr.io/anomalyco/opencode
初始化配置
安装完成后，进入项目目录并运行：
cd /path/to/your/project && opencode init
初始化时选择：
•Provider：选择AI模型提供商（Ollama本地模型，或OpenAI/DeepSeek在线API）
•Language：选择Chinese，让Agent优先使用中文
配置国内模型
在国内使用，推荐配置DeepSeek：
export OPENAI_BASE_URL="https://api.deepseek.com/v1"
export OPENAI_API_KEY="sk-xxxxxxxx"
写入 ~/.zshrc 或 ~/.bashrc 后执行 source ~/.zshrc 生效。
第一个项目实战
安装配置完成后，让我们通过一个实际例子感受OpenCode的工作流程。
场景：给现有项目添加新功能
假设你有一个简单的Express.js项目，想让它支持用户认证：
cd my-express-project && opencode
实战对话示例
•第一步：让OpenCode理解你的项目
请简单介绍一下这个代码库的结构和主要功能
•第二步：引用具体文件提问
@routes/users.js 这个路由文件有什么问题？如何改进？
•第三步：让它添加功能
请在 @routes/auth.js 中添加JWT登录和注册接口
•第四步：执行命令验证
!npm run test
双模式交互：Plan vs Build
OpenCode有两个核心模式，这是它和Cursor/Claude Code的重要区别：
•Plan模式（只读）：分析代码、规划方案，不修改任何文件，适合复杂任务前的思考
•Build模式（完整权限）：执行代码修改、运行终端命令、实际交付成果
使用方式：复杂任务先切到Plan模式出方案，确认后再切到Build模式执行，按Tab键快速切换。
核心功能详解
1. 代码生成与重构
OpenCode不仅能生成新代码，还能理解整个项目上下文，进行智能重构。
常用指令：
•把这个函数改写成async/await风格
•@utils/helper.js 第15行到第30行，提取为一个独立函数
•给这个类添加完整的TypeScript类型定义
2. 多模型切换
这是OpenCode最大的优势之一。你不需要被单一模型绑定：
# 查看可用模型/models
# 临时切换模型/model claude-sonnet-4-5
模型选择策略：
•简单任务（写脚本、格式化）：用DeepSeek或本地模型，低成本
•复杂任务（架构设计、算法）：用Claude或GPT，高准确率
•敏感项目：用本地Ollama部署的开源模型，完全离线
3. 文件引用与上下文
使用@符号引用文件，让OpenCode理解你的意图：
@controllers/UserController.ts 这个控制器的性能如何优化？
@models/*.ts 所有模型文件的命名规范是否一致？
4. 终端命令执行
使用!前缀执行Shell命令：
!git status
!npm run build
5. Agent系统
OpenCode支持主Agent和子Agent，可以自定义权限、模型和提示词：
{ "agents": { "code-reviewer": { "model": "claude-sonnet-4-5", "permission": "read-only", "prompt": "你是一个严格的代码审查专家..." } } }
进阶技巧
1. 自定义命令
在.opencode/commands/目录下创建自定义命令：
# .opencode/commands/review.md
审查 @$1 的代码质量，关注性能、安全和可维护性
2. 会话管理
•/init：初始化项目，生成AGENTS.md
•/export：导出会话为Markdown
•/share：生成可分享的会话链接
•/undo / /redo：撤销/重做
3. 上下文压缩
长对话时启用自动压缩，避免超出上下文限制：
{ "compaction": { "auto": true, "prune": true } }
4. 团队协作
在项目根目录创建AGENTS.md，定义项目规范。团队成员共享此文件，OpenCode会自动遵循这些规则。
常见问题解决
•command not found: opencode：全局安装路径未加入PATH，执行 npm config get prefix 检查
•国内网络慢：npm config set registry https://registry.npmmirror.com
•EACCES: permission denied：执行 sudo chown -R $(whoami) ~/.local && chmod -R 755 ~/.local
•Windows用户：官方强烈建议通过WSL运行OpenCode
与Cursor/Claude Code的对比
•开源免费：OpenCode MIT协议免费，Cursor $20/月，Claude Code按量付费
•模型自由：OpenCode支持75+模型，其他两款都深度绑定自家模型
•工作流：OpenCode和Claude Code都是CLI优先，Cursor是IDE优先
•自托管：只有OpenCode支持完全自托管，适合敏感项目
什么时候选OpenCode：终端重度用户、需要模型自由切换、关心成本和开源、需要自托管。
什么时候选Cursor：前端/全栈开发者、重度依赖IDE图形化功能、团队已经在用Cursor。
什么时候选Claude Code：追求单次任务最高准确率、项目复杂度高、不太在意成本。
写在最后
OpenCode的登顶，不是某一款工具的胜利，而是开放、解耦、社区驱动理念的胜利。
对于普通开发者，我的建议是：不要急着"换掉"现有工具，而是把OpenCode加进你的工具箱。就像你同时用Git和SVN、Docker和Podman一样，多一个选择不是坏事。
如果你追求长期、灵活、低成本、不被锁定，OpenCode在2026年已经成为最值得托付的开源选项。
关键命令速查：
# 安装
curl -fsSL https://opencode.ai/install | bash
# 启动
opencode
# 切换模式：Tab键
# 切换模型
/model
# 执行命令
!
作者：L
微信公众号：效率补丁
试过才推荐，好用才分享。
参考来源
•OpenCode GitHub仓库：https://github.com/anomalyco/opencode
•OpenCode官方文档：https://opencode.ai/docs
•LogRocket《AI Dev Tool Power Rankings》2026年6月版
•OpenCode中文指南：https://opencodeguide.com/zh/