OpenCode：在终端环境中运行的AI编程智能体

OpenCode 是一个专为终端环境设计的AI编程智能体。它完全开源，允许开发者在不离开命令行界面的情况下，完成代码的生成、修改和调试等任务。这个工具的核心特点是它的灵活性和开放性。它不依赖于任何特定的AI模型供应商，用户可以根据自己的需求和偏好，选择接入Anthropic、OpenAI、Google的模型，甚至是部署在本地的私有模型。这种设计不仅避免了供应商锁定，也让用户能从模型价格和性能的持续竞争中受益。OpenCode采用客户端/服务器（Client/Server）架构，这意味着它的核心服务可以运行在一台计算机上，而开发者可以通过另一台设备（例如笔记本电脑或移动设备）远程连接并操作它。对于习惯使用Neovim等终端工具的开发者来说，OpenCode提供了无缝衔接的交互体验，将AI编程能力直接集成到他们最熟悉的工作环境中。

Function List

• 终端原生体验：提供一个完整的终端用户界面（TUI），让开发者可以在命令行中与AI进行流畅交互。
• 模型无锁定：支持接入多种大型语言模型，包括Anthropic（推荐）、OpenAI、Google以及本地运行的开源模型。
• open source：项目100%开源，采用MIT许可证，开发者可以自由审查、修改和分发。
• 客户端/服务器架构：允许将AI智能体服务部署在远程服务器上，并通过本地终端或其他客户端进行连接和操作。
• 跨平台安装：提供多种便捷的安装方式，支持macOS、Linux等主流操作系统，并适配不同的包管理器。
• community-driven：项目由社区共同维护，鼓励开发者贡献代码，修复错误和完善文档。

Using Help

OpenCode 作为一个面向开发者的终端工具，其安装和使用流程都经过了精心设计，旨在简化操作，让用户可以快速上手。

Installation process

OpenCode 提供了多种安装方式，以适应不同操作系统和用户偏好。选择最适合你环境的一种即可。

1. 快速安装（推荐）

对于大多数 macOS 和 Linux 用户，最快捷的安装方式是使用官方提供的一键安装脚本。打开你的终端，复制并执行以下命令：

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

这个脚本会自动检测你的系统环境，并将 OpenCode 安装到合适的目录中。

2. 使用包管理器安装

如果你习惯使用包管理器来管理你的软件，OpenCode 也提供了相应的支持。

• 对于 npm / bun / pnpm / yarn 用户::
  你可以通过 npm 将 OpenCode 作为全局工具安装。

  npm i -g opencode-ai@latest
  

• 对于 macOS 和 Linux 的 Homebrew 用户::
  首先，你需要添加 sst/tap 这个软件源，然后直接安装。

  brew install sst/tap/opencode
  

• 对于 Arch Linux 用户::
  You can use the paru 或者其他 AUR 助手来安装 opencode-binThe

  paru -S opencode-bin
  

Important Notes：在安装新版本之前，请确保卸载掉所有版本号低于 0.1.x 的旧版本，以避免冲突。

自定义安装目录

默认情况下，安装脚本会按照以下优先级顺序来确定安装路径：

1. $OPENCODE_INSTALL_DIR：如果你设置了这个环境变量，它将被用作最高优先级的安装目录。
2. $XDG_BIN_DIR：遵循 XDG 基本目录规范的路径。
3. $HOME/bin：如果存在或可以被创建，则使用此标准的个人二进制文件目录。
4. $HOME/.opencode/bin：默认的备用安装路径。

如果你希望将 OpenCode 安装到特定位置，例如 /usr/local/bin，可以在执行安装脚本前设置环境变量：

OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

Basic use

安装完成后，你就可以在终端中直接启动和使用 OpenCode。其核心交互模式非常直观，你可以在终端中通过对话的方式，向AI智能体下达指令。

1. 启动 OpenCode::
   In the terminal, type opencode 命令并回车，即可启动它的终端用户界面（TUI）。
2. Interacting with AI::
   启动后，你会进入一个交互式环境。在这里，你可以像使用聊天工具一样，直接输入你的需求。例如：
   • “请帮我写一个 Python 函数，用来计算斐波那契数列。”
   • “分析一下这段代码的性能瓶颈，并给出优化建议。”
   • “将这个JSON文件转换成CSV格式。”
3. 代码操作::
   当 AI 生成代码后，你可以方便地进行复制、修改或直接保存到文件中。OpenCode 的 TUI 设计参考了 Neovim 等终端编辑器的操作习惯，使得整个流程非常高效。

Configuration

OpenCode 的一个重要特性是它不绑定任何一家AI模型供应商。你需要在配置文件中指定你希望使用的模型。详细的配置方法，可以参考其官方文档。通常，你需要提供所选AI服务商的API密钥（API Key），并将其配置到 OpenCode 的设置中。这样，你就可以灵活切换，始终选择性价比最高的模型来为你服务。

更详细的配置和高级用法，例如如何设置本地模型、如何进行远程连接等，请访问官方文档获取进一步的指导。

application scenario

1. 终端内的快速开发与原型验证
   开发者在终端环境下工作时，无需切换到浏览器或IDE。当需要编写一个新函数、实现某个算法或解析一段数据时，可以直接在终端里启动OpenCode，通过自然语言描述需求，AI会迅速生成对应的代码片段。开发者可以立即将代码用于当前项目，极大地提升了开发效率。
2. 远程服务器编程与维护
   当通过SSH连接到远程服务器进行开发或维护时，通常无法使用图形化界面的工具。OpenCode作为一款终端原生工具，可以在远程服务器上完美运行。无论是编写部署脚本、分析日志文件，还是快速修复线上代码，它都能提供强大的AI辅助能力。
3. 学习新技术与API
   在学习一门新的编程语言、框架或不熟悉的库时，开发者常常需要查阅大量文档。通过OpenCode，可以直接提问，例如“如何使用requests库在Python中发送一个带认证的POST请求？”或者“请展示一个使用React Hooks实现计时器的例子”，AI会直接给出可运行的代码示例，加速学习过程。
4. Automation scripting
   对于系统管理员和DevOps工程师来说，编写Shell脚本、Python脚本来自动化日常任务是家常便饭。OpenCode可以作为强大的脚本编写助手，帮助他们快速生成用于文件处理、系统监控或服务管理的脚本代码，减少手动编写的错误和时间。

QA

1. OpenCode 和 Claude Code 有什么不同？
   它们在能力上很相似，但主要有以下几点关键区别：
   • 开源性：OpenCode是100%开源的，而Claude Code是闭源产品。
   • Model Flexibility：OpenCode不与任何单一供应商绑定，支持OpenAI、Google、Anthropic以及本地模型，让用户有更多选择。
   • interactive interface：OpenCode专注于终端用户界面（TUI），为命令行用户提供了极致的交互体验。
   • build：采用客户端/服务器架构，支持远程操作，增加了使用的灵活性。
2. OpenCode支持哪些AI模型？
   OpenCode支持多种主流的大语言模型服务，包括但不限于Anthropic（官方推荐）、OpenAI（如GPT系列）、Google（如Gemini系列）。同时，它也支持连接本地部署的开源模型，给予用户充分的选择自由。
3. 我应该如何为OpenCode项目做贡献？
   项目团队欢迎社区的贡献，尤其是以下几个方面：修复程序错误、提升LLM的性能、增加对新AI模型供应商的支持、解决特定环境下的兼容性问题、完善文档等。但是，对于核心功能的重大改动，需要先通过设计流程与核心团队进行讨论。建议在提交PR（Pull Request）前，先查看项目的贡献历史，了解哪些类型的合并请求更容易被接受。