文档
中文文档
介绍

介绍

OpenCode 是一款开源的 AI 编程助手，提供终端界面、桌面应用和 IDE 扩展。它让开发者能够与 AI 交互完成代码相关的任务。

前置要求

在终端中使用 OpenCode 之前，你需要：

  1. 现代终端模拟器 - 可选：

    • WezTerm（跨平台）
    • Alacritty（跨平台）
    • Ghostty（Linux 和 macOS）
    • Kitty（Linux 和 macOS）

  2. API 密钥 - 你选择的 LLM Provider 的凭证

安装

通用安装

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
 
# Paru (Arch Linux)
paru -S opencode-bin
 
# Chocolatey (Windows)
choco install opencode
 
# Scoop (Windows)
scoop bucket add extras && scoop install extras/opencode
 
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

配置

  1. 在终端界面中执行 /connect 命令
  2. 选择你偏好的 Provider
  3. 在 opencode.ai/auth 进行身份验证
  4. 配置计费信息
  5. 获取并输入 API 密钥

我们推荐新手使用 OpenCode Zen - 一个经过测试的模型集合。

项目初始化

进入项目目录并启动：

cd /path/to/project
opencode

初始化项目：

/init

这会在项目根目录生成 AGENTS.md 文件，建议将其提交到版本控制。

核心用法

询问代码库

使用 @ 搜索项目文件：

@packages/functions/src/api/index.ts 中的身份验证是如何处理的？

功能开发

  1. 计划模式（Tab 键）- AI 提出实现方案但不做修改
  2. 迭代 - 通过反馈和视觉参考完善计划
  3. 构建模式（Tab 键）- 执行批准的更改

撤销更改

  • 撤销命令：/undo
  • 重做命令：/redo
  • 支持多次撤销

协作

通过以下命令分享对话：

/share

这会生成一个分享链接并复制到剪贴板。

个性化

自定义你的体验：

  • 主题选择
  • 键盘绑定
  • 代码格式化器
  • 自定义命令
  • 配置设置
配置