OpenCode：你的开源 AI 编程助手完全指南

先说一个核心趋势：随着大语言模型在代码生成领域的成熟度不断提升，开发者对于既灵活又私密的本地化AI编程工具需求正在快速增长。OpenCode恰恰切中了这个痛点的最新组合——它是一款开源、隐私优先的编程助手，可以直接在终端、IDE或桌面应用中使用。

从市场表现来看，这个项目在GitHub上已经斩获了5万余枚星标，背后有超过500位活跃贡献者，每月活跃用户稳定在65万以上。这组数据本身就说明了它在开发者社区中的真实认同度。

核心特性一览

值得关注的几个核心特性：它非常强调“开箱即用”，内置免费模型的同时也允许连接任意主流的模型提供商——Claude、GPT、Gemini等都能无缝接入；支持终端、桌面和IDE扩展多种平台；集成了LSP支持，自动为LLM加载合适的语言服务器；支持多会话协作，可以在同一个项目上启动多个并行的袋里——这在处理复杂任务时特别重要；还提供了会话分享功能，方便团队调试或参考。

还有一点不得不提：隐私保护。OpenCode严格遵循隐私优先的原则，不会存储任何代码或上下文数据。这意味着即便在敏感环境的项目中使用，也无需担心数据外泄。

快速开始——三条路径搞定安装

安装方式相当灵活。无论你偏好哪种方式，OpenCode都为你准备了多种选择。

方式一：一键安装脚本（推荐）
curl -fsSL https://opencode.ai/install | bash

方式二：包管理器

Node.js 用户可以通过npm、pnpm、Bun或Yarn安装： npm install -g opencode-ai

macOS/Linux上的Homebrew用户： brew install anomalyco/tap/opencode

Windows上则有Chocolatey和Scoop两种选择： choco install opencode

如果是Arch Linux用户，使用Paru： paru -S opencode-bin

配置AI模型提供商

首次使用需要配置一个AI模型提供商。对新手来说，推荐直接使用OpenCode Zen——这是OpenCode团队测试和验证过的精选模型列表，品质有保障。操作上很简单：运行/connect命令，选择opencode提供商，访问opencode.ai/auth进行登录，添加付款信息并复制API Key，最后粘贴即可完成。

当然，如果已经拥有其他提供商（如Anthropic Claude、OpenAI）的订阅，同样可以通过/connect直接接入。

初始化项目

进入你的项目目录并运行OpenCode：

cd /path/to/your/project
opencode

随后运行/init命令，OpenCode会自动分析项目结构并创建AGENTS.md文件。这个文件帮助OpenCode理解项目的结构和编码模式，从而更精准地提供建议。

使用OpenCode：从基础到进阶

终端界面（TUI）基础操作

启动OpenCode后，你会进入一个交互式终端界面。操作很直观：

• 提问与请求：直接输入问题，比如“给我一个这个代码库的快速总结”，OpenCode会自动分析并回复。
• 引用文件（@符号）：用@加上文件名进行模糊搜索并引用文件，文件内容会自动添加到对话中。例如“@packages/functions/src/api/index.ts 中的身份验证是如何处理的？”——这是一种非常自然的上下文注入方式。
• 运行Bash命令（!符号）：在消息开头使用!就能执行shell命令，输出结果会自动进入对话，方便调试过程中实时获取反馈。

常用Slash Commands

OpenCode提供了一套完整的Slash Commands，可以通过快捷键快速调用：

进阶用法：计划模式与构建模式

OpenCode内置了两种工作模式，通过Tab键切换，这个设计非常实用——尤其是处理复杂功能时。

计划模式（Plan Mode）：OpenCode会给出实现建议，但不会直接修改代码。这个模式适合复杂功能的规划和审视。比如：

当用户删除笔记时，我们希望在数据库中将其标记为已删除。然后创建一个屏幕显示所有最近删除的笔记。从这个屏幕，用户可以恢复笔记或永久删除它。

构建模式（Build Mode）：这是默认模式，OpenCode收到指令后会实际执行代码修改。如果确认了计划，可以切换回构建模式说一句“听起来不错！开始执行更改吧”——这点值得强调。

IDE集成与快捷键

OpenCode支持嵌入到VS Code、Cursor、Windsurf、VSCodium等主流IDE中使用。在VS Code的集成终端中运行opencode时，扩展会自动安装。也可以手动搜索“OpenCode”直接安装。

IDE中的快捷键也很体贴：

• Cmd+Esc (Mac) / Ctrl+Esc (Win/Linux) — 打开/聚焦 OpenCode
• Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Win/Linux) — 启动新会话
• Cmd+Option+K (Mac) / Alt+Ctrl+K (Win/Linux) — 插入文件引用

此外，OpenCode还能自动共享当前选中的内容或标签页，支持拖拽图片到终端，支持多会话并行工作。

命令行高级用法

除了交互式TUI，OpenCode还提供了一组强大的命令行工具：

• 列出可用模型：opencode models。可以列出所有提供商或特定提供商的模型，也可以使用--refresh刷新缓存。
• 快速执行命令：opencode run "解释 Ja vaScript 中的闭包"。不启动TUI直接执行，加上-m指定模型，加上-f附加文件。
• 查看统计信息：opencode stats。支持按天数和项目筛选。
• 会话管理：opencode session list列出所有会话，opencode export 导出会话，opencode import session.json导入会话。
• 启动Web服务：opencode web启动Web界面，可指定端口和主机名。
• 启动后端服务：opencode serve启动无头服务器，远程客户端可通过opencode attach https://10.20.30.40:4096连接。

配置与定制

配置文件位于~/.config/opencode/opencode.json，数据目录在~/.local/share/opencode/。在TUI中可以通过/themes切换主题。默认快捷键前缀是Ctrl+x，可以在配置文件中自定义。

值得注意的是，OpenCode支持多种代码格式化器，确保修改过的代码自动符合你的项目风格。通过配置文件还可以添加自定义工具、设置项目规则、配置袋里行为、设定LSP服务器。

实用技巧：用好OpenCode的几个关键点

总结几个实战中特别高效的操作方式：

1. 给OpenCode足够的上下文
把它当作初级开发者来对话——提供详细的说明和示例，效果远超简单指令。比如：

我们需要给 /settings 路由添加身份验证。参考 @packages/functions/src/notes.ts 中 /notes 路由的实现方式，在 @packages/functions/src/settings.ts 中实现相同的逻辑。

2. 使用图片辅助
拖拽设计图到终端，让OpenCode参照设计来实现功能。

3. 先计划后执行
对于复杂功能，先切换到计划模式获取实现方案，确认后再切换回构建模式执行——这个流程能大幅减少返工。

4. 设置外部编辑器
配置EDITOR环境变量，可以在/editor和/export命令中使用喜欢的编辑器（如VS Code、Neovim）。

5. 多会话并行
同时启动多个OpenCode会话处理不同任务，通过/sessions命令快速切换。

常见问题

OpenCode是免费的吗？
本身完全免费开源，但AI模型的用量需要付费。OpenCode Zen提供了经过优化的模型选择，降低使用成本。

可以用已有的AI订阅吗？
当然可以。OpenCode支持连接75+ LLM提供商，包括Anthropic Claude、OpenAI GPT系列、Google Gemini以及本地模型等。

数据会存储在OpenCode服务器吗？
不会。这是最重要的特性之一：OpenCode不存储任何代码或上下文数据，确保隐私安全。

支持哪些编辑器？
终端界面、桌面应用（Beta）、VS Code、Cursor、Windsurf、VSCodium等主流IDE，以及任何支持终端的编辑器。

资源链接

• 官网：opencode.ai
• 文档：opencode.ai/docs
• GitHub：github.com/anomalyco/opencode
• Discord社区：opencode.ai/discord
• 模型目录：models.dev

总结

OpenCode是一个功能扎实且设计灵活的开源AI编程助手。无论是加速日常开发节奏、快速理解陌生代码库，还是自动化重复性工作，它都能提供实质性的帮助。最关键是它尊重隐私、不存储代码，同时覆盖了几乎所有主流AI模型和开发环境——这样的组合在当前市场上相当罕见。

马上试试吧：

curl -fsSL https://opencode.ai/install | bash
opencode

本文信息基于OpenCode官方文档，如有更新请以官方文档为准。