MacOS/Linux/Windows 跨平台一键安装OpenCode指南

MacOS/Linux/Windows安装OpenCode

1. 执行以下命令

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

Windows推荐：使用 WSL

为了在 Windows 上获得最佳体验，我们推荐使用 Windows Subsystem for Linux (WSL)。它提供更好的性能，并完全兼容 OpenCode 的所有功能。

使用 Chocolatey

choco install opencode

使用 NPM

npm install -g opencode-ai

2. 启动OpenCode 配置 模型

输入启动命令

opencode

如果出现未找到命令执行以下命令

source ~/.bashrc

启动成功后进入 TUI 界面

终端输入 /models 可以查看免费的模型：

回车后会出现模型列表，右侧有Free是免费模型

配置完模型后可以进行聊天

3. 自定义配置

1. 全局配置（~/.config/opencode/opencode.json）- 用户偏好

自定义 Base URL

你可以通过设置 baseURL 选项来自定义任何提供商的 Base URL。这在使用代理服务或自定义端点时非常有用。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.anthropic.com/v1"
      }
    }
  }
}

4. 使用

1. 进入你想要使用的项目目录

2. 启动opencode

opencode

3. 项目初始化

/init

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

4. 让opencode写一个功能

等待一会，等控制台提示创建完成后查看

直接访问index页面

5. 日常交互

• 直接提问：例如 “解释 src/main.ts 中的认证逻辑”。
• 添加功能：描述需求，如 “添加用户注册 API，支持邮箱验证”。
• 切换模式：按 Tab 键切换 Plan/Build 模式（Plan 更安全，用于规划）。
• 撤销变更：/undo
• 重做：/redo
• 分享会话：/share