OpenCode 安装指南

面向零基础小白用户的完整安装教程

一、OpenCode 是什么？

OpenCode 是一款开源 AI 编程助手，能直接在终端里帮你：

• 写代码、调程序

• 解释代码意思

• 重构优化代码

你可以理解为：一个随时在命令行里工作的 AI 编程专家。

本教程以 OpenCode 官方 为例进行说明

二、安装前的准备

你需要准备：

1. 终端：Windows Terminal（Microsoft Store 免费安装）或 Git Bash

2. AI API：OpenCode 内置免费模型，不用额外准备

三、Windows 安装（任选一种）

方法一：Scoop 安装（推荐）

第一步：安装 Scoop

以管理员身份打开 PowerShell，执行：

iwr -useb get.scoop.sh | iex

第二步：安装 OpenCode

scoop install opencode

第三步：验证

opencode--version

看到版本号（如 `v1.x.x`）即表示安装成功。

方法二：npm 安装

第一步：检查 Node.js

node--version

如果没有，去 https://nodejs.org/ 下载安装。

檢查是否安好:在cmd中輸入 node -v

第二步：安装 OpenCode

npm  install-g opencode-ai@latest

第三步：验证

opencode--version

四、首次使用

启动

cd 你的项目目录opencode

输入 /models 选择免费模型

当前免费可用模型（会随时变化，以 /models 显示为准）：

输入 /init 初始化项目

/init

这会让 OpenCode 分析你的项目结构，生成一个 `AGENTS.md` 文件，帮助 AI 更好地理解你的代码。

然后就可以开始对话了，例如：

帮我写一个计算器程序

帮我解释这段代码

五、快捷键大全

命令类快捷键

操作类快捷键

文本编辑快捷键

六、常见问题与解决

问题 1：提示找不到 opencode 命令

原因：PATH 环境变量未更新

解决：

1. 重启 PowerShell

2. 或手动添加到 PATH：[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Users\你的用户名\AppData\Roaming\npm", "User")

问题 2：提示需要登录 API

原因：免费模型已达上限

解决：

1. 输入 /models 换一个免费模型

2. 或使用 /connect 连接 OpenCode 官方付费账号

问题 3：响应很慢或卡住

原因：网络问题或免费模型限流

解决：

1. 检查网络

2. 换一个免费模型

3. 等待几秒后重试

问题 4：npm 安装报错

原因：Node.js 版本太旧

解决：

1. 升级 Node.js：npm install -g n && n latest

2. 或使用 Scoop 方法安装

问题 5：Scoop 安装报错

原因：权限不足

解决：确保以管理员身份运行 PowerShell

问题 6：免费模型用完了

原因：免费模型有 IP 级别限额

解决：

1. 换一个免费模型试试

2. 等待段时间后再试

3. 或连接付费 API

七、核心步骤总结

1. 用 Scoop 或 npm 安装：scoop install opencode

2. 启动：opencode

3. 输入 /models 选免费模型

4. 输入 /init 初始化

5. 开始让 AI 帮你编程

参考资料

• 官网：opencode.ai

• GitHub：github.com/anomalyco/opencode

• 文档：opencode.ai/docs