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. 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