进阶 opencode.ai 2026-11-11 16:13:22 · 28 阅读

第1章 OpenCode V1 简介与安装指南

简介

OpenCode 是一个开源的 AI 编程代理,提供基于终端的界面、桌面应用以及 IDE 扩展三种形式。

让我们开始吧。

先决条件

要在终端中使用 OpenCode,你需要:

  • 一款现代终端模拟器,例如:
    • WezTerm,跨平台
    • Alacritty,跨平台
    • Ghostty,支持 Linux 和 macOS
    • Kitty,支持 Linux 和 macOS
  • 打算使用的 LLM 提供商的 API 密钥。

安装 OpenCode 1 最简单的方式是使用安装脚本。这些安装方法会提供 opencode 二进制文件,可能会与现有的 OpenCode 2 安装发生冲突或将其覆盖。

在终端中运行以下命令:

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

你也可以使用以下命令进行安装:

使用 Node.js

npm install -g opencode-ai 或 bun install -g opencode-ai,也可以用 yarn global add opencode-ai

在 macOS 和 Linux 上使用 Homebrew

brew install anomalyco/tap/opencode

上述 Homebrew 指令用于安装 V1 版本。目前 Homebrew 的 brew install opencode 指令安装的是 V2 版本。请参阅 V2 文档。

在 Arch Linux 上安装

sudo pacman -S opencode (适用于 Arch Linux,安装 OpenCode 2) paru -S opencode-bin (适用于 Arch Linux,从 AUR 安装 OpenCode 1)

官方 Arch 软件包安装的是 OpenCode 2。若要安装 OpenCode 1,请使用 AUR 软件包。

Windows

使用 Chocolatey

choco install opencode

使用 Scoop

scoop install opencode

使用 NPM

npm install -g opencode-ai

使用 Mise

mise use -g github:anomalyco/opencode

使用 Docker

docker run -it --rm ghcr.io/anomalyco/opencode

使用 Bun 在 Windows 上安装 OpenCode 的支持功能正在开发中。

你也可以从发布页面获取二进制文件。

通过配置 API 密钥,你可以让 OpenCode 使用任意 LLM 提供商。

如果你是 LLM 提供商的新手,建议使用 OpenCode Models。这是一个由 OpenCode 团队测试并验证过的精选模型列表。

在 TUI 中运行 /connect 命令,选择 opencode,然后前往 opencode.ai/auth。

/connect

登录,添加你的账单详细信息,并复制你的 API 密钥。

粘贴你的 API 密钥。 ┌ API key │ │ └ 回车

或者,你可以选择其他提供商之一。了解更多详情。

配置好提供商后,你可以导航到想要处理的项目目录。

cd /path/to/project

然后运行 OpenCode。

opencode

接下来,通过运行以下命令为该项目初始化 OpenCode。

/init

这将让 OpenCode 分析你的项目,并在项目根目录创建一个 AGENTS.md 文件。

这有助于 OpenCode 理解项目结构以及所使用的编码模式。

现在,你准备好使用 OpenCode 处理你的项目了。尽管问它任何问题!

如果你是 AI 编程代理的新手,以下是一些可能有用的示例。

你可以让 OpenCode 向你解释代码库。

@packages/functions/src/api/index.ts 中的认证是如何处理的?

如果你没有参与代码库某部分的开发,这会很有帮助。

你可以让 OpenCode 为你的项目添加新功能。不过,我们建议你首先让它制定一个计划。

制定计划

OpenCode 具有 Plan 模式,该模式会禁用其修改代码的能力,而是建议如何实施该功能。

使用 Tab 键切换到该模式。你会在右下角看到相应的指示器。

切换到 Plan 模式

现在让我们描述我们想要它做什么。

当用户删除一条笔记时,我们希望将其在数据库中标记为已删除。

然后创建一个界面,显示最近删除的所有笔记。

在此界面上,用户可以恢复删除或永久删除该笔记。

你需要给 OpenCode 足够的细节,以便它理解你的需求。把它当作团队里的初级开发人员来交流会有所帮助。

迭代计划

当它给出计划后,你可以提供反馈或补充更多细节。

我希望使用之前用过的一个设计来设计这个新界面。

[图像 #1] 看一下这张图片,并将其作为参考。

OpenCode 可以扫描你提供的任何图像,并将其添加到提示词中。你可以将图像拖放到终端中来完成此操作。

构建功能

一旦你对计划感到满意,再次按下 Tab 键切换回 Build 模式。

并要求它进行更改。

听起来不错!请继续更改。

对于更直接的更改,你可以要求 OpenCode 直接构建,而无需先查看计划。

我们需要在 /settings 路由中添加认证功能。看看 @packages/functions/src/notes.ts 中 /notes 路由是如何处理此功能的,并在 @packages/functions/src/settings.ts 中实现相同的逻辑。

确保提供足够的细节,以便 OpenCode 做出正确的更改。

假设你要求 OpenCode 进行一些更改。

你能重构 @packages/functions/src/api/index.ts 中的函数吗?

但随后你发现这不是你想要的。你可以使用 /undo 命令撤销更改。

/undo

OpenCode 现在将恢复你所做的更改,并再次显示你最初的消息。

你能重构 @packages/functions/src/api/index.ts 中的函数吗?

从这里你可以调整提示词并要求 OpenCode 再试一次。

或者你可以使用 /redo 命令重做更改。

/redo

就是这样!你现在已经是 OpenCode 使用的大师了。

为了使其更符合你的使用习惯,我们建议选择一个主题、自定义键位绑定、配置代码格式化器、创建自定义命令,或尝试 OpenCode 配置选项。

评论 (0)