02 · 安装、连接模型与第一次运行

第一次使用 OpenCode 的目标不是马上让它改复杂项目，而是确认三件事：

1. CLI 能正常启动。
2. 模型 provider 已连接。
3. OpenCode 能读取当前项目并完成一轮可控对话。

安装方式

官方推荐安装脚本：

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

也可以通过 Node.js 包管理器安装：

npm install -g opencode-ai

macOS / Linux 用户也可以使用 OpenCode tap：

brew install anomalyco/tap/opencode

Windows 用户可以直接安装，但官方更推荐在 WSL 中使用。原因不是“Windows 不能跑”，而是 coding agent 对文件系统、终端、shell、权限和开发工具链依赖很重，WSL 的兼容性通常更稳定。

第一次启动

进入一个 Git 仓库，然后运行：

opencode

不带参数时，OpenCode 默认启动 TUI。你也可以指定项目路径：

opencode /path/to/project

首次启动后，先不要直接让它大改代码。更稳的检查方式是：

先快速阅读这个仓库的目录结构，不要修改文件。告诉我入口文件、主要模块和你不确定的地方。

这条提示词有三个好处：

• 它要求只读，降低误改风险。
• 它能验证 OpenCode 是否能读取项目上下文。
• 它会暴露模型是否理解当前代码结构。

连接模型供应商

在 TUI 中可以使用：

/connect

它会引导你选择 provider 并填写 API key。也可以通过配置文件写入 provider 和 model。

如果你只是快速试用，先用 /connect。如果你要给团队复用，应该写进项目配置，至少明确默认模型和权限边界。

用 run 做非交互检查

OpenCode 也支持非交互命令：

opencode run "Explain the structure of this repository"

这适合接入脚本、CI 或简单自动化。但第一次上手建议先用 TUI，因为 TUI 更容易观察模型行为、工具调用和上下文压缩。

第一轮任务怎么选

第一轮不要选“重构整个项目”。选一个低风险、可验证、边界清楚的任务：

只修改 README 中的安装说明，把命令整理成 macOS、Linux、Windows 三段。不要改其他文件。

这类任务能验证 OpenCode 的三项基础能力：

• 能否按文件边界执行。
• 能否解释改动。
• 能否接受你后续的修正。

如果这一轮都不稳定，再谈 agent、skill、MCP 或自动化没有意义。