OpenCode安装指南2026

OpenCode是最火的开源编程智能体，但安装文档默认你懂生态。

💡 你将学到

OpenCode是最火的开源编程智能体，但安装文档默认你懂生态。

📜 目录

• OpenCode 安装指南 2026：Windows、Mac 和 Linux 上 5 分钟搞定
• 前置条件：Node.js 20+
• 安装
• 连接模型
• 首次会话
• 常用参数
• 常见问题
• 相关文章

OpenCode 安装指南 2026：Windows、Mac 和 Linux 上 5 分钟搞定

OpenCode 是一款面向终端环境的开源 AI 编程代理（GitHub 星标 191,500）。本指南将带你完成三大平台的安装，并连接你的第一个模型。

前置条件：Node.js 20+

node --version

OpenCode 通过 npm 分发。如果尚未安装，请先安装 Node.js LTS 版本。

安装

npm install -g opencode

安装就这么简单。验证一下：

opencode --version

连接模型

首次运行时，OpenCode 会询问你要使用哪个提供商。以下是三种最快的路径：

路径 A - Anthropic（质量最佳）：

opencode auth login
# 按照浏览器提示完成授权

路径 B - OpenRouter（一个密钥，多种模型）：

export OPENROUTER_API_KEY=sk-or-...
opencode --model openrouter/anthropic/claude-sonnet-4

路径 C - 通过 Ollama 使用免费本地模型：

ollama pull qwen2.5-coder:7b
opencode --model ollama/qwen2.5-coder:7b

首次会话

cd /path/to/your/project
opencode

输入一个任务，比如：“解释这个仓库的架构，并为 auth 模块添加一个测试”。OpenCode 会读取仓库、提出修改建议，并在编辑前征求你的批准。

常用参数

常见问题

OpenCode 支持 Windows 吗？ 支持，通过 Node 原生运行于 Windows。部分 MCP 服务器更推荐 WSL2，但核心功能完全正常。

使用成本是多少？ 工具本身免费；你只需支付模型 API 的使用费用（使用小型模型时，每次会话仅需几美分）。

可以和 VS Code 一起用吗？ 可以，有专门的 VS Code 扩展可以嵌入 OpenCode。

相关文章

• 零成本本地AI编程：Ollama + Continue.dev 从零搭建（Mac/Windows/Linux全平台）
• OpenRouter教程：一个API Key用所有LLM
• One API（3.6万星）大模型网关搭建指南2026：一个Key打通OpenAI、Claude、Gemini和DeepSeek

❓ 常见问题

OpenCode 支持 Windows 吗？

支持，通过 Node 原生运行于 Windows。部分 MCP 服务器更推荐 WSL2，但核心功能完全正常。

使用成本是多少？

工具本身免费；你只需支付模型 API 的使用费用（使用小型模型时，每次会话仅需几美分）。

可以和 VS Code 一起用吗？

可以，有专门的 VS Code 扩展可以嵌入 OpenCode。