目录
AI 编程助手：OpenCode 使用指南
叫我_叼哥
编辑于 2026年02月05日 10:16

是什么

OpenCode是一款开源的AI编程助手，能在终端、IDE或桌面环境中辅助用户编写代码。

核心定位与功能优势

终端原生的开发体验

  • 完全适配终端环境，无需切换到浏览器或IDE插件，让终端重度开发者可以在熟悉的环境中完成从需求分析到代码实现的全流程开发

  • 轻量高效的命令行交互模式，通过/init、/undo、/share等简洁命令操作，避免复杂的界面干扰，保持专注的编码状态

灵活自由的模型选择

  • 支持接入75+大语言模型提供商，既可以选择新手友好的OpenCode Zen一键配置，也可以自定义接入OpenAI、Anthropic等主流平台的模型

  • 全面兼容本地部署模型，支持登录GitHub Copilot、ChatGPT Plus/Pro账号，直接调用对应AI能力

  • 自动适配加载对应LLM的语言服务器协议（LSP），提升代码编写的适配性与流畅度

强大的协作与多任务处理能力

  • 多任务并行处理：可在同一项目中同时启动多个智能代理，高效推进多模块开发

  • 协作共享便捷：生成会话链接，方便团队成员参考或协作调试代码，实现AI辅助开发过程的知识共享

开源安全与全场景适配

  • 采用MIT许可证，支持本地部署，代码数据完全在本地处理，适合对隐私有严格要求的行业和项目

  • 提供终端界面、桌面应用、IDE扩展三种使用形式，适配不同编程场景和开发者习惯

对比其他几家AI工具

适合人群推荐

  • 终端重度用户：习惯使用命令行完成大部分开发工作，希望在不离开终端的前提下获得AI辅助

  • 隐私敏感型开发者：处理涉及敏感数据的项目，需要代码数据完全在本地处理

  • 模型探索者：希望尝试不同AI模型的编程能力，追求模型选择的灵活性

  • 协作型团队：需要在团队内共享AI辅助开发过程，提升团队协作效率

怎么用

下载&安装

下载地址：https://opencode.ai/download

终端方式使用

使用安装命令

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

windows：npm install -g opencode-ai（需要先安装Node.js）

为了获得最佳的 Windows 体验，建议使用适用于 Linux 的 Windows 子系统 (WSL)。它能提供更佳的性能，并与 OpenCode 的各项功能完全兼容。

IDE方式使用

  • 安装插件：打开 VS Code，在扩展商店中搜索“OpenCode”，找到官方插件后点击安装。其他主流 IDE（如 JetBrains 系列、Neovim）也可通过对应插件市场搜索安装。

  • 启动：打开目标项目后，在 IDE 内置终端中输入 opencode 命令启动 AI 助手。

  • 配置模型：输入 /connect 命令，可选择粘贴第三方模型 API Key 连接外部模型（如 Claude、GPT-4），或直接使用内置的免费开源模型（如 GLM-4.7）。

  • 使用：在终端中输入自然语言需求，如“帮我优化这段代码的性能”“解释这个函数的逻辑”，实时查看 AI 生成的代码建议和分析。

  • 高级功能：输入 / 查看所有可用命令（如 /init 初始化项目、 /undo 撤销修改、 /share 分享会话）；使用 @ 符号引用项目文件（如 @src/utils.ts），AI 将直接分析该文件并提供针对性建议。

桌面应用方式使用

  • 安装：根据操作系统下载对应版本的安装包，完成安装配置。支持 Windows、macOS 和 Linux 系统。（下载的OpenCode_Desktop_Installer.exe文件可能会被判定带了木马病毒）

  • 启动：打开 OpenCode 桌面应用，点击“选择项目”按钮加载本地开发项目，应用会自动识别项目结构和技术栈。

  • 配置模型：在应用左侧设置面板中，可直接选择内置免费模型开始使用；也可点击“添加模型”按钮，输入第三方平台 API Key 连接 Claude、GPT-4 等高级模型。

  • 使用：在界面底部输入框中输入开发需求，如“帮我生成用户登录页面的 React 组件”“修复这个 API 接口的错误”，AI 会在右侧面板实时输出代码和解释。

  • 高级功能：输入 / 触发命令菜单；使用 @ 引用项目文件；支持拖拽图片到输入框，让 AI 参考设计图生成代码；点击“会话分享”按钮生成链接，与团队成员协作调试。

配置

OpenCode支持接入任意大语言模型提供商，你只需配置对应平台的API密钥即可使用。

运行命令启动：opencode auth login

新手推荐：使用OpenCode Zen一键配置

OpenCode Zen这是一个由OpenCode官方团队精心筛选、测试并验证过的模型列表，能帮你快速上手，避开模型选择的繁琐步骤：

  1. 打开OpenCode的终端交互界面（TUI），输入指令 /connect 并回车执行

  2. 在弹出的提供商选择列表中，选择“opencode”选项

  3. 系统会自动跳转至授权页面 opencode.ai/auth，你也可以手动在浏览器中打开该链接

  4. 在授权页面完成账号登录，按照提示添加支付信息（支持多种主流支付方式）

  5. 登录成功后，复制页面显示的专属API密钥

  6. 返回OpenCode终端界面，在“API key”输入框中粘贴刚刚复制的密钥，按回车完成配置

进阶选择：自定义接入其他模型提供商

如果你已有熟悉的大语言模型提供商，也可以直接选择对应平台进行配置：

  1. 同样在OpenCode终端中执行 /connect 指令

  2. 在提供商列表中选择你需要的平台（如OpenAI、Anthropic等）

  3. 按照系统提示前往对应平台的官网获取API密钥（通常在平台的“API设置”或“开发者中心”页面）

  4. 将获取到的API密钥粘贴至OpenCode的输入框中完成配置

  5. 如需了解更多模型提供商的接入细节，可以点击“Learn more”查看官方详细文档

纯免费选择

  1. 在OpenCode终端中执行/model指令

  2. 系统会列出所有已配置和内置的免费模型

  3. 上下键切换选择到免费模型即可

项目初始化与环境准备

进入项目目录：打开终端，使用cd命令切换到你要开发的项目路径

cd /path/to/project

启动OpenCode：在项目目录下输入以下命令启动OpenCode

opencode

初始化项目：输入初始化命令，让OpenCode分析项目结构并生成配置文件

/init

项目分析与配置：OpenCode会自动扫描项目代码结构、依赖文件和技术栈，在项目根目录生成AGENTS.md文件，记录项目的关键信息和AI代理配置

💡 实用小贴士：

建议将AGENTS.md文件提交到Git仓库，这样OpenCode在后续开发中能更好地理解项目结构和编码规范，提供更精准的代码建议

核心功能使用指南

代码咨询与理解

你可以随时向OpenCode询问代码库的相关问题，快速了解陌生代码：

  • 使用@键模糊搜索项目文件：输入@后跟随文件名或路径片段，OpenCode会自动匹配相关文件

  • 示例用法：

代码块
Plain
自动换行
复制代码
请解释@packages/functions/src/api/index.ts中的认证逻辑是如何实现的？
复制成功

  • 适用场景：快速理解团队其他成员编写的代码、接手新项目时熟悉代码结构

新功能开发流程

OpenCode提供"计划模式"和"构建模式"两种工作模式，建议遵循"先规划再开发"的流程：

  1. 创建开发计划

    1. 切换计划模式：按Tab键切换到计划模式，界面右下角会显示模式标识

    2. 详细描述需求：像给团队新同事分配任务一样，清晰说明功能需求

代码块
Plain
自动换行
复制代码
需求：实现笔记回收站功能
1. 用户删除笔记时，在数据库中将其标记为已删除而非物理删除
2. 创建回收站页面，展示所有最近删除的笔记
3. 在回收站页面支持恢复笔记和永久删除笔记的操作
复制成功

  • 提供设计参考：可直接将设计图拖拽到终端中，OpenCode会自动识别图片内容作为参考

  • 迭代完善计划

    1. 收到计划方案后，你可以提出修改意见或补充细节

代码块
Plain
自动换行
复制代码
请参考我之前使用过的设计风格来做这个回收站页面，具体样式见附件图片
复制成功

  • OpenCode会根据你的反馈优化计划，直到你满意为止

  • 执行功能开发

    1. 切换回构建模式：再次按Tab键切换到构建模式

    2. 确认开发：输入确认指令，OpenCode会自动完成代码编写

代码块
Plain
自动换行
复制代码
计划没问题了，开始开发吧！
复制成功

快速代码修改

对于简单明确的代码修改，你可以直接要求OpenCode进行开发，无需经过计划阶段：

代码块
Plain
自动换行
复制代码
请为/settings路由添加认证功能，参考/notes路由的实现方式，代码位于@packages/functions/src/notes.ts，请在@packages/functions/src/settings.ts中实现相同的逻辑
复制成功

💡 实用小贴士：

提供越详细的上下文和参考示例，OpenCode生成的代码质量越高

代码回滚与重做

如果对OpenCode生成的代码不满意，可以随时回滚：

撤销最近修改：输入/undo命令，OpenCode会恢复到修改前的状态

  • /undo

重做撤销的修改：输入/redo命令，可重新应用之前撤销的修改

  • /redo

多次撤销：可重复执行/undo命令，撤销多步修改

会话分享与团队协作

你可以将与OpenCode的对话分享给团队成员，方便协作和知识共享：

生成分享链接：输入/share命令，OpenCode会生成当前会话的链接并复制到剪贴板

  • /share

分享给团队：将链接发送给团队成员，他们可以查看完整的对话过程和代码修改建议

隐私保障：对话内容默认不会自动共享，只有主动执行分享命令才会生成链接

总结

OpenCode是一款专为命令行开发者打造的开源AI编程助手，它将强大的AI能力无缝集成到终端环境中，为习惯命令行工作流的开发者提供了更自然、高效的编程体验。以下是对其核心价值、使用要点的系统总结：

使用要点与注意事项

  1. 终端环境要求：需要支持TUI（终端用户界面）的现代终端，推荐使用WezTerm、Alacritty、Kitty等终端模拟器，以获得最佳体验

  2. 成本控制策略：

    1. 使用内置免费模型可零成本体验核心功能，适合个人开发者和小型项目

    2. 第三方AI模型需按使用量付费，Claude Pro订阅（$20/月）在代码生成能力和性价比上表现突出，适合有稳定需求的开发者

    3. 支持本地部署模型，可大幅降低长期使用成本

  3. 代码质量保障：

    1. AI生成的代码建议经过人工审查后再提交，特别是涉及安全、认证等关键逻辑部分

    2. 建议使用"计划模式"先规划再开发，通过多轮迭代完善需求，减少后续修改成本

    3. 利用/undo和/redo功能灵活调整代码，确保最终实现符合需求

  4. 最佳实践：

    1. 提交AGENTS.md到Git仓库，帮助OpenCode更好地理解项目结构和编码规范

    2. 学会使用@键模糊搜索文件，提升代码咨询的精准度

    3. 对于复杂功能，先通过计划模式明确开发方案，再进行代码实现

价值与局限性认知

  1. 不可替代的辅助价值：

    1. 显著提升重复编码任务的效率，如代码生成、格式统一、简单功能实现等

    2. 降低学习成本，通过自然语言交互快速理解陌生代码库

    3. 减少手动编码错误，特别是在遵循现有代码规范方面表现出色

  2. 明确的能力边界：

    1. 无法替代人类开发者的核心能力，如需求分析、架构设计、复杂问题解决等

    2. AI生成的代码需要人工审查，尤其是涉及业务逻辑和安全的部分

    3. 依赖开发者提供清晰的需求描述和上下文信息

cv45258610