OpenCode 保姆级教程：从 0 安装 → 配置 → 完整创建一个 Hello World 项目

OpenCode 是开源的 AI 编程代理（类似 Claude Code / Cursor 的免费开源版），在终端里就能让 AI 帮你写代码、建项目、调试、运行。支持免费模型、任意 API（Claude/GPT/Gemini/Ollama 等），超级好用！

下面是100% 可复制操作的教程，保证你 15-30 分钟内跑通一个完整 Hello World 项目。

第一步：安装 OpenCode（2 分钟）

推荐方式（最简单，所有系统通用）：

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

复制上面整行，直接粘贴到终端回车（macOS/Linux 用 Terminal，Windows 用 PowerShell）。

其他方式（任选其一）：
- macOS/Linux：brew install anomalyco/tap/opencode
- Windows（推荐）：打开 PowerShell，输入 choco install opencode 或 scoop install opencode
- 通用：npm install -g opencode-ai（需先装 Node.js 20+）

验证安装成功：

opencode --version

看到版本号（如 1.x.x）就成功了！

小贴士：
- Windows 小白先装 Chocolatey 或 Scoop（网上搜“Windows Scoop 安装” 1 分钟搞定）。
- 安装完重启终端窗口。

第二步：配置 AI 模型（最关键！免费可用）

1. 随便找个文件夹，输入 opencode 启动（先不用管项目）。
2. 在 OpenCode 界面输入命令：
   /connect
3. 选择 opencode（推荐 OpenCode Zen），浏览器会打开 https://opencode.ai/auth
   - 注册/登录 → 添加账单（有免费额度或低价模型）→ 复制 API Key
   - 粘贴回终端，回车。

完全免费方案（推荐小白）：
- 去 https://aistudio.google.com/app/apikey 免费申请 Gemini API Key
- 在 OpenCode 里输入 /models → 搜索 gemini → 粘贴你的 Key。
- 或直接用内置免费模型（OpenCode 自带几个可用模型）。

配置好后输入 /share 测试，能看到分享链接就成功啦！

第三步：创建一个新项目文件夹

mkdir opencode-hello-world && cd opencode-hello-world

（这就是我们的 Hello World 项目文件夹）

第四步：启动 OpenCode + 初始化项目

opencode

界面出现后，输入：

/init

AI 会自动分析文件夹，生成 AGENTS.md（以后项目都会自动识别规范）。

第五步：让 AI 一键完成 Hello World 项目（核心！）

在 OpenCode 输入框里直接复制粘贴下面这句话（超级详细提示，小白必备）：

请用 Python 创建一个完整的 Hello World 项目：
1. 创建 app.py 文件，里面写一个函数打印 "Hello World! 我是用 OpenCode 创建的超级棒项目！🎉"
2. 创建 README.md，写清楚：如何安装依赖、如何运行（python app.py）
3. 创建 requirements.txt（空也行）
4. 直接用 Build 模式帮我全部生成并保存文件。
请一步到位，完成后告诉我怎么测试运行。

操作技巧（很重要）：
- 输入完提示后按 Tab 键切换到 Build 模式（界面下方会显示 Build）。
- AI 会思考、列计划、生成代码、问你确认 → 输入 yes 或 go ahead 让它执行。
- 它会自动创建/编辑文件（你会看到代码高亮修改）。

整个过程 10-30 秒，AI 就帮你建好所有文件了！

进阶提示（想更酷）：
换成下面这段，让它做 Node.js Web 版 Hello World：

用 Node.js + Express 创建一个 Web Hello World 项目：
- app.js 监听 3000 端口，访问 / 返回 JSON {"message": "Hello World from OpenCode! 🚀"}
- 添加 package.json 和 README.md（npm start 如何运行）
直接 Build 实现，完成后帮我运行测试。

第六步：测试运行项目（验证成功！）

AI 完成后，输入以下命令让它执行：

请在终端帮我运行：python app.py   （或 node app.js）

或者直接输入：

/run python app.py

（或 /bash npm start）

你会看到终端输出：

Hello World! 我是用 OpenCode 创建的超级棒项目！🎉

大功告成！ 项目文件已经真实存在于你的文件夹里，可以用 VS Code 打开查看。

常用快捷键 & 命令（记住这些就够日常用了）

• Tab：切换 Plan（规划） / Build（执行）模式
• Ctrl + C：中断当前思考
• /undo：撤销上次修改
• /redo：重做
• /models：切换模型（试试 Claude / Gemini）
• /share：生成分享链接发给朋友
• 输入 help 查看所有命令

可选：桌面版（更像 App，推荐小白）

去 https://opencode.ai/zh/download 下载 macOS/Windows/Linux 桌面 Beta 版，双击安装即可（界面更漂亮，同样支持上面所有操作）。

常见问题解决

• 命令 not found？重启终端或 source ~/.zshrc
• API 报错？换 Gemini 免费 Key 或 OpenCode Zen
• Windows 权限问题：PowerShell 输入 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• 想本地完全免费？先装 Ollama（ollama.com），然后在 OpenCode 输入 ollama 模型即可。

恭喜你！现在你已经完整走通了 安装 → 配置 → 创建真实项目 → 运行 全流程。

接下来你可以直接输入：“帮我做一个 TODO List Web App” 或者 “把这个项目改成 React 前端”…… AI 就会继续帮你迭代！