OpenCode 初次使用教程

简介

OpenCode 是一个开源的 AI 编程助手，可以帮助你在终端、IDE 或桌面应用中编写代码。它支持 75+ 种 LLM 提供商，包括 Claude、GPT、Gemini 等。

安装

快速安装（推荐）

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

使用包管理器安装

Node.js

npm install -g opencode-ai
# 或
bun install -g opencode-ai
# 或
pnpm install -g opencode-ai
# 或
yarn global add opencode-ai

Homebrew (macOS/Linux)

brew install anomalyco/tap/opencode

Windows

choco install opencode
# 或
scoop install opencode

配置

OpenCode 需要配置 AI 模型提供商的 API 密钥。

使用 OpenCode Zen（推荐新手）

运行 OpenCode 后，输入 /connect 命令
选择 opencode
访问 https://opencode.ai/auth
登录并添加付款信息
复制 API 密钥并粘贴

其他提供商

OpenCode 支持 75+ 种 LLM 提供商，你可以选择其他提供商（如 OpenAI、Anthropic、Google 等），具体配置方法详见官方文档。

配置自定义模型

设置默认模型

在 OpenCode 配置文件中设置默认模型：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "provider_id/model_id"
}

示例：

OpenCode Zen："model": "opencode/gpt-5.1-codex"
Anthropic："model": "anthropic/claude-sonnet-4-5"
OpenAI："model": "openai/gpt-5"

配置模型选项

全局配置模型的选项：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "gpt-5.2",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "apiyi",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "sk-xxxx"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o",
          "reasoning": false,
          "tools": true,
          "limit": {
            "context": 10000,
            "output": 5000
          }
        },
        "gpt-5.2": {
          "name": "gpt-5.2",
          "reasoning": false,
          "tools": true,
          "limit": {
            "context": 10000,
            "output": 5000
          }
        },
        "gpt-4o-mini": {
          "name": "gpt-4o-mini",
          "reasoning": false,
          "tools": true,
          "limit": {
            "context": 10000,
            "output": 5000
          }
        }
      }
    }
  }
}

@anthropic-ai/claude-agent-sdk

配置文件位置：

macOS/Linux: ~/.config/opencode/config.json
Windows: %APPDATA%\opencode\config.json

配置说明：

npm: 使用的 AI SDK 包
name: 提供商名称
options: 基础 URL 等选项
models: 可用模型列表及配置
reasoning: 是否启用推理模式
tools: 是否支持工具调用

选择模型

在 OpenCode 中使用 /models 命令选择模型。

初始化项目

导航到你的项目目录：
```
cd /path/to/project
```
运行 OpenCode：
```
opencode
```
初始化项目：
```
/init
```

这会分析你的项目并创建 AGENTS.md 文件（建议将其提交到 Git）。

基本使用

提问

使用 @ 符号可以模糊搜索项目中的文件：

解释一下 @packages/functions/src/api/index.ts 中的认证逻辑

添加功能

1. 创建计划

按 Tab 键切换到计划模式
描述你想要的功能
例如：删除笔记时标记为已删除，创建回收站页面，可以恢复或永久删除

2. 迭代优化

对计划提出反馈
添加更多细节
可以拖拽图片到终端作为参考

3. 构建功能

再次按 Tab 键切换回构建模式
让 OpenCode 执行更改

直接修改

对于简单的更改，可以直接让 OpenCode 执行：

给 /settings 路由添加认证，参考 @packages/functions/src/notes.ts 中的实现

撤销和重做

/undo - 撤销更改
/redo - 重做更改

可以多次使用 /undo 来撤销多个操作。

分享会话

使用 /share 命令可以创建当前会话的分享链接。

高级配置

主题：选择你喜欢的主题
快捷键：自定义快捷键绑定
代码格式化：配置代码格式化工具
自定义命令：创建自定义命令
配置文件：详细配置 OpenCode 行为

隐私

OpenCode 不会存储你的代码或上下文数据，适合在隐私敏感环境中使用。

获取帮助

开始使用 OpenCode，让 AI 助你高效编程！

OpenCode 初次使用教程