首页 > 专题 > AI编程 > 文章详情
返回 AI编程

1、OpenCode安装与使用指南

2026年02月08日 25 阅读 AI编程

简介

OpenCode是一款开源的AI编程助手,支持终端界面、桌面应用和IDE扩展。它可以帮助开发者阅读代码、添加新功能、重构代码、修复bug等。通过配置不同的LLM提供商,开发者可以使用各种AI模型来完成编程任务。

前置要求

在安装OpenCode之前,请确保满足以下条件:

  1. 终端模拟器: 需要安装现代终端软件

    • WezTerm (跨平台)
    • Alacritty (跨平台)
    • Ghostty (Linux/macOS)
    • Kitty (Linux/macOS)

  2. API密钥: 需要准备LLM提供商的API密钥

Node.js 安装

参考地址：https://www.begincode.net/article/art_8d82f1d4bf8a

Linux环境安装

方式一: 一键安装脚本 (推荐)

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

方式二: 使用Node.js包管理器

# npm
npm install -g opencode-ai

# Bun
bun install -g opencode-ai

# pnpm
pnpm install -g opencode-ai

# Yarn
yarn global add opencode-ai

方式三: Homebrew (macOS和Linux)

brew install anomalyco/tap/opencode

> 推荐使用OpenCode官方Tap以获取最新版本。

方式四: Paru (Arch Linux)

paru -S opencode-bin

Windows环境安装

> 推荐: Windows用户建议使用WSL (Windows Subsystem for Linux),可获得更好的性能和兼容性。WSL安装方式请参考Windows官方文档。

方式一: Chocolatey

choco install opencode

方式二: Scoop

scoop install opencode

方式三: NPM

PowerShell 会有权限问题，使用cmd 安装

npm install -g opencode-ai

方式四: Mise

mise use -g github:anomalyco/opencode

方式五: Docker

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

方式六: 手动下载

也可从GitHub Releases页面下载二进制文件直接使用。

配置过程（可跳过直接使用免费模型）

1.命令行直接输入 opencode 进入opencode

连接LLM提供商

  1. 执行连接指令:
/connect

2.选择要用的LLM 回车

  1. 将API密钥粘贴到终端
┌ API key│
└ enter

也可选择其他LLM提供商,详情参考官方文档。

初始化项目

进入项目目录

cd /path/to/your/project

启动OpenCode

opencode

选择可用模型

 /models

初始化项目

/init

此命令会让OpenCode分析项目结构并在项目根目录创建AGENTS.md文件。建议将AGENTS.md提交到Git,以帮助OpenCode理解项目代码风格和结构。

核心命令使用

斜杠命令 (/)

斜杠命令是OpenCode的内置功能,用于执行特定操作:

| 命令 | 功能说明 |
|------|----------|
| /connect | 连接LLM提供商,获取API密钥 |
| /init | 初始化项目,创建AGENTS.md |
| /undo | 撤销最后一次修改 |
| /redo | 重做已撤销的修改 |
| /share | 分享当前对话到团队 |
| /models | 切换模型，选择Free标识的免费模型即可 |

@符号使用

@符号用于快速搜索和引用项目中的文件:

How is authentication handled in @packages/functions/src/api/index.ts

在提问时使用@可以:

  • 模糊搜索项目文件
  • 快速定位要分析或修改的代码文件
  • 为AI提供准确的上下文

常用操作示例

询问代码问题

How is authentication handled in @packages/functions/src/api/index.ts

计划模式 (Tab键切换)

在执行前可先让OpenCode制定计划:

  1. 按Tab键切换到计划模式
  2. 描述需求:
当用户删除笔记时,我们希望将其标记为数据库中的已删除状态。然后创建一个屏幕显示所有最近删除的笔记。用户可以从该屏幕恢复笔记或永久删除。
  1. 迭代和完善计划
  2. 再次按Tab键切换回构建模式,执行计划

直接修改

对于简单直接的修改,可以要求OpenCode直接执行:

We need to add authentication to the /settings route. Take a look at how this is handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts

撤销和重做

/undo    # 撤销修改
/redo    # 重做修改

可多次执行以撤销或重做多步操作。

分享对话

/share

此命令会创建当前对话的链接并复制到剪贴板,方便与团队成员分享。默认情况下对话不会自动分享。

进阶配置

安装完成后,可根据个人需求进行以下自定义:

  • 更换主题 (Themes)
  • 自定义快捷键 (Keybinds)
  • 配置代码格式化工具 (Formatters)
  • 创建自定义命令 (Commands)
  • 修改OpenCode配置 (Config)

总结

OpenCode的安装过程简单直接,支持多种平台和安装方式。掌握斜杠命令和@符号的使用可以大幅提升开发效率。建议新手从简单的代码阅读和问题询问开始,逐步尝试添加功能和重构代码。

OpenCode