OpenCode 是由 SST 团队（Serverless Stack 框架的创造者）开发的一款开源 AI 编程代理，运行在终端中。它能帮你读代码、写代码、改 Bug、执行命令，与 Cursor 或 Claude Code 功能相当，但具有以下独特优势： **核心优势：** - **100% 开源**：代码完全公开，社区驱动，透明可控 - **不绑定任何厂商**：支持国产模型（Kimi、Qwen、GLM 等）和国际模型 - **终端原生**：对 Vim / Neovim 用户极其友好，深度优化 TUI 体验 - **内置 LSP 支持**：开箱即用的代码智能提示 - **价格友好**：官方 Go 订阅首月仅 $5，就能用上多种顶级模型 --- ## 安装方式 **方式一：一键脚本（推荐）** ```bash curl -fsSL https://opencode.ai/install | bash ``` **方式二：包管理器** ```bash # npm / bun / pnpm / yarn npm i -g opencode-ai@latest # macOS / Linux brew install anomalyco/tap/opencode ``` **方式三：桌面应用（Beta）** 不习惯终端？OpenCode 也提供桌面版（macOS / Windows / Linux），可从官方 GitHub Releases 页面下载：github.com/anomalyco/opencode/releases --- ## 首次启动 安装完成后，进入项目目录，直接运行： ```bash opencode ``` 你会看到一个终端 UI 界面，底部有输入框，可以直接用自然语言跟 AI 对话。 --- ## 选择模型方案（重点！） OpenCode 支持多种模型提供商，你有两种方式：官方订阅（推荐）或自带 API Key。 ### 方案 A：OpenCode Go（强烈推荐，首月仅 $5） **价格**：首月 $5（约 36 元），之后 $10 / 月（约 72 元） **包含的国产顶级模型：** | 模型 | 来自厂商 | 每5小时请求数 | |------|---------|-------------| | GLM-5.1 | 智谱 AI | 3,450 | | Kimi K2.6（限时3倍用量） | 月之暗面 | 1,290 | | MiMo-V2.5-Pro | 小米 | 3,300 | | Qwen3.6 Plus | 阿里巴巴 | 3,400 | | MiniMax M2.7 | MiniMax | 10,200 | **开通步骤：** 1. 访问 opencode.ai/go 2. 注册账号并订阅 Go 计划 3. 按照页面提示配置即可开始使用 ### 方案 B：OpenCode Zen（高端之选） 如需 Claude、OpenAI 等国际顶级模型，可使用 OpenCode Zen（opencode.ai/zen），按用量付费，最低充值 $20。 ### 方案 C：自带 API Key 如已有 API Key，配置环境变量即可： ```bash export ANTHROPIC_API_KEY="your-api-key-here" # Claude export OPENAI_API_KEY="your-api-key-here" # OpenAI export GOOGLE_API_KEY="your-api-key-here" # Google Gemini ``` --- ## 两种 Agent 模式 OpenCode 内置两种 Agent，按 Tab 键即可切换： **Build 模式（默认）** - 完整权限，可读写文件、执行命令 - 适合：写功能、改 Bug、重构代码 - 会直接修改你的文件 **Plan 模式（只读）** - 只读权限，不会修改任何文件 - 运行命令前会征求你的同意 - 适合：探索陌生代码库、分析架构 **使用技巧**：当你不确定 AI 会做什么时，先切到 Plan 模式看看方案，满意了再切回 Build 执行。 --- ## 常用快捷键 | 快捷键 | 功能 | |--------|------| | Tab | 切换 Build / Plan 模式 | | Enter | 发送消息 | | Ctrl+C | 取消当前操作 | | Ctrl+L | 清屏 | | @general | 调用通用子 Agent 处理复杂任务 | --- ## 实战场景示例 **场景 1：让 AI 帮你写新功能** ``` > 在 src/utils/ 目录下创建 dateUtils.ts， > 实现 formatDate、parseDate、isExpired 三个函数， > 使用 dayjs，包含完整类型定义和单元测试 ``` **场景 2：分析陌生代码库** ``` > （先按 Tab 切到 Plan 模式） > 分析这个项目的整体架构： > 1. 技术栈 2. 目录结构 3. 核心业务逻辑 4. 潜在问题 ``` **场景 3：修复 Bug** ``` > 用户登录后 token 过期时页面面白屏， > 排查 src/api/auth.ts 和 src/middleware/， > 找到原因并修复 ``` **场景 4：代码重构** ``` > orderService.ts 超过 800 行， > 按单一职责原则拆分为多个模块， > 保持对外接口不变 ``` --- ## 配置文件 在项目根目录创建 opencode.json： ```json { "model": "claude-sonnet-4-20250514", "provider": "anthropic", "theme": "dark" } ``` | 配置项 | 说明 | 示例值 | |--------|------|--------| | model | 使用的模型 | claude-sonnet-4-20250514 | | provider | 模型提供商 | anthropic / openai / google | | theme | 界面主题 | dark / light | --- ## 与 Claude Code / Cursor 的对比 | 特性 | OpenCode + Go | Claude Code | Cursor | |------|---------------|-------------|--------| | 开源 | **100% 开源** | 闭源 | 闭源 | | 国产模型 | **Kimi·Qwen·GLM·MiMo** | 不支持 | 部分支持 | | LSP 支持 | **内置** | 无 | 内置 | | 终端 UI | **深度优化** | 标准终端 | GUI | | 月费 | **首月 $5，之后 $10** | ~$20+ | $20 | **选择建议：** - **预算有限**：OpenCode Go 是目前性价比最高的方案，首月 $5 就能用上多种顶级模型 - **想用国产模型**：OpenCode Go 是目前唯一整合了 Kimi、Qwen、GLM 等国产模型的编程助手 - **终端重度用户**：OpenCode 的 TUI 体验远超其他方案，对 Neovim 用户极友好 - **需要顶级闭源模型**：可使用 OpenCode Zen 或自带 Anthropic / OpenAI API Key --- ## 常见问题 **Q：OpenCode 免费吗？** OpenCode 软件本身 100% 免费开源。使用模型需要付费，推荐 OpenCode Go 订阅（首月仅 $5）。 **Q：OpenCode Go 和 Zen 有什么区别？** - **Go（$5/月起）**：主打国产模型（Kimi、Qwen、GLM、MiMo、MiniMax），价格低，适合日常编程 - **Zen（按用量付费）**：主打 Claude、OpenAI 等国际闭源模型，适合需要最强模型的场景 **Q：支持哪些国产模型？** 目前支持：智谱 GLM-5/5.1、月之暗面 Kimi K2.5/K2.6、小米 MiMo-V2 系列、阿里 Qwen3.5/3.6 Plus、MiniMax M2.5/M2.7。 **Q：跟 Cursor 比有什么优势？** 价格更低（首月 $5 vs $20），不依赖 VS Code 纯终端运行、资源占用极低，开源可控数据不经过第三方，支持远程场景（服务器运行 + 手机操控），国产模型支持更好。 **Q：Windows 能用吗？** 可以。推荐通过 Scoop 或 Chocolatey 安装，也可以直接用 npm。 **Q：怎么更新？** ```bash npm i -g opencode-ai@latest # npm 安装 brew upgrade opencode # brew 安装 ``` --- > 📌 **项目地址**：github.com/anomalyco/opencode > 💰 **Go 订阅**：opencode.ai/go