OpenCode 是一款专为开发者打造的开源 AI 编码智能体（AI Coding Agent），支持在终端、IDE 和桌面环境中使用。它可以连接包括 Claude、GPT、Gemini 在内的多种大模型服务，也提供经过官方基准测试与验证的精选免费模型，让你在不同环境下都能获得稳定、高质量的智能编码体验。OpenCode 不存储你的代码或上下文数据，适合对隐私和合规要求较高的团队和企业使用。

产品详细介绍

OpenCode 的核心定位是“开源 AI 编码智能体”，帮助开发者在日常开发流程中更高效地编写、阅读和维护代码。无论你习惯在终端、IDE 还是桌面应用中工作，都可以通过 OpenCode 将 AI 能力无缝集成到现有工作流中。

开源与社区生态

  • 完全开源：代码公开透明，便于企业进行安全审计和二次开发。
  • 庞大社区：拥有超过 140,000 GitHub Star、850+ 贡献者、11,000+ 次提交，形成了活跃的生态与快速迭代能力。
  • 广泛使用：每月有超过 650 万开发者使用，经过大规模生产环境验证。

多模型与多提供商支持

  • 支持多家模型提供商：可连接 Claude、GPT、Gemini 等主流大模型服务，也可接入其他兼容的模型 API。
  • 内置免费模型：即使没有自有 API Key，也可以通过内置的免费模型快速体验和使用。
  • 模型可插拔：根据项目需求自由切换或组合不同模型，适配不同语言、场景和成本要求。

Zen 精选模型（Validated Models）

  • Zen 模型集：官方精选并基准测试的一组专为“编码智能体场景”优化的模型。
  • 质量稳定：避免不同提供商之间质量不一致的问题，减少调参和踩坑成本。
  • 开箱即用：无需自行评估大量模型，只需选择经过验证的模型组合即可投入生产使用。

隐私与安全

  • 不存储代码与上下文：OpenCode 不会保存你的代码片段、项目内容或上下文数据，适合隐私敏感环境。
  • 本地与内网友好：可在本地或内网环境中部署和使用，满足企业安全与合规要求。
  • 可审计可定制：由于是开源项目，安全团队可以审查代码，并根据内部规范进行定制和加固。

使用场景与能力示例

  • 代码生成与补全：根据自然语言描述生成函数、类或模块代码，提升开发效率。
  • 代码解释与学习：对复杂代码进行逐行解释，帮助快速理解陌生代码库。
  • 重构与优化建议：提出重构方案、性能优化建议和更优雅的实现方式。
  • 多语言支持：适用于多种编程语言和技术栈，覆盖前端、后端、脚本、数据工程等场景。
  • 终端/IDE/桌面一体化：在命令行、常用 IDE 以及桌面环境中统一使用同一套智能体能力。

简单使用教程

以下为基于典型使用流程整理的简明上手步骤，具体命令和界面以官方文档与仓库说明为准。

一、环境准备与安装

  1. 确认基础环境：
    • 已安装 Git
    • 已安装 Node.js / Python / 或项目要求的运行环境（视官方仓库说明而定）
  2. 获取源码或安装包：
    • 访问官网或 GitHub 仓库，获取安装说明
    • 可选择：
      • 使用包管理器安装（如 npm、pip、brew 等）
      • 或直接克隆仓库进行本地构建与运行
  3. 完成依赖安装：
    • 在项目目录中执行相应依赖安装命令（如 npm install、pip install -r requirements.txt 等）。

二、配置模型与提供商

  1. 使用内置免费模型（快速体验）：
    • 在配置文件或设置界面中选择官方提供的免费模型，无需额外 API Key。
  2. 连接外部模型提供商：
    • 在各大模型平台（如 OpenAI、Anthropic、Google 等）申请 API Key。
    • 在 OpenCode 的配置文件或设置界面中填入对应的 API Key 和模型名称。
    • 可为不同场景配置不同模型，例如：
      • 代码生成使用某模型
      • 代码审查使用另一个模型
  3. 启用 Zen 精选模型：
    • 在模型列表中选择 Zen 提供的“已验证模型”组合。
    • 根据官方推荐的默认配置启用，无需复杂调参。

三、在终端中使用

  1. 启动 OpenCode 终端工具：
    • 在命令行中运行相应启动命令（例如 opencode 或项目文档中的 CLI 命令）。
  2. 在项目目录中工作：
    • 切换到你的代码仓库目录，确保 OpenCode 能读取到当前项目结构。
  3. 常见交互方式：
    • 提问代码相关问题：
      • 如：解释当前目录下某个文件的逻辑
    • 生成代码片段：
      • 描述你想实现的功能，让智能体生成函数或脚本
    • 辅助调试：
      • 将错误日志或堆栈信息粘贴给智能体，获取排查建议

四、在 IDE 或桌面中使用

  1. 安装插件或桌面客户端：
    • 在常用 IDE（如 VS Code 等）的插件市场搜索并安装对应的 OpenCode 插件（如有）。
    • 或下载官方桌面客户端，完成安装。
  2. 登录与配置：
    • 在插件或客户端中配置模型来源（内置模型或外部 API）。
    • 选择是否启用 Zen 精选模型，以获得更稳定的编码体验。
  3. 典型使用方式：
    • 选中一段代码，右键调用 OpenCode 进行解释、重构或优化。
    • 在侧边栏输入自然语言需求，让智能体生成新文件或模块。
    • 在编辑器中实时获得补全建议和重构提示。

五、加入候补名单（早期访问 Zen 等功能）

  1. 访问官网：
    • 打开官网首页，找到 Zen 或早期访问相关入口。
  2. 填写信息：
    • 提交邮箱、使用场景等信息，加入候补名单。
  3. 等待通知：
    • 获得早期访问资格后，根据邮件或站内通知完成激活与配置。

常见问题 FAQ

1. OpenCode 是免费的吗？
OpenCode 本身是开源项目，可免费使用。但如果你连接的是第三方模型提供商（如某些商用大模型），则可能需要根据其计费规则支付 API 费用。内置的免费模型可用于快速体验和日常开发。

2. 我可以在公司内网或离线环境中使用吗？
可以。OpenCode 是开源的，可在本地或内网环境中部署。你可以根据公司安全策略选择只使用本地模型或内网可访问的模型服务，并对代码进行安全审计和定制。

3. OpenCode 会保存我的代码或项目数据吗？
不会。官方明确说明 OpenCode 不存储你的代码或上下文数据，适合隐私敏感和合规要求较高的场景。具体数据流和日志策略可在源码中审查和配置。

4. 一定要有自己的 API Key 才能用吗？
不一定。你可以直接使用 OpenCode 提供的免费模型进行体验和日常开发。如果需要更强大的模型或特定提供商的能力，再配置自己的 API Key 即可。

5. Zen 精选模型和普通模型有什么区别？
Zen 是官方基于编码智能体场景精心挑选和基准测试的一组模型组合，重点优化了代码生成、重构、解释等任务的稳定性和质量。使用 Zen 可以减少你在不同模型之间反复试错和调参的时间，更适合直接用于生产环境。

6. 我可以为 OpenCode 做贡献吗？
可以。作为一个拥有大量贡献者的开源项目，OpenCode 欢迎社区参与。你可以通过提交 Issue、Pull Request、文档改进或插件扩展等方式参与贡献，具体流程可参考 GitHub 仓库中的贡献指南。

7. 支持哪些编程语言？
OpenCode 依赖所连接的大模型能力，通常可以支持主流编程语言（如 JavaScript/TypeScript、Python、Java、Go、C/C++、Rust 等）。在实际使用中，你可以根据项目语言选择更擅长该语言的模型，以获得更好的效果。