[ByAIGC] Windows 从零装 AI 编程代理（二）：opencode

本文 首发于 🌱 煎茶， 转载 请注明 来源。

说明：本文为 AIGC 辅助撰写整理，基于官方文档核实，供快速上手参考。具体细节以官方文档为准。

opencode 是开源（MIT）的终端 AI 编程代理，支持几乎任意大模型提供商，也是本系列其他工具的好搭档。

1. 安装

opencode 在 Windows 上可以用 npm、Scoop 或 Chocolatey 安装。推荐用 npm（上一篇已装好 Node）：

npm install -g opencode-ai

验证：

opencode --version

想用包管理器也行：scoop install opencode 或 choco install opencode。官方在 Windows 上最推荐 WSL，但原生 PowerShell 也能用。

2. 配置模型提供商（API Key）

opencode 支持任意 LLM，只要配置对应提供商的 API Key 即可。首次运行会在界面里引导你选择。

• 最简单（官方托管）：在终端输入 /connect，选 opencode，按提示到 https://opencode.ai/auth 登录获取 Key 后粘贴回来。
• 自带 Key：也可在配置中填入任意兼容提供商（如 DeepSeek、Anthropic、OpenAI 等）的 ANTHROPIC_API_KEY / OPENAI_API_KEY 等。

3. 初始化一个项目

进入你的项目目录并启动：

cd 你的项目路径
opencode

在界面里运行：

/init

opencode 会分析项目并生成一份 AGENTS.md（记录项目结构与编码规范）。建议把它提交到 Git 里。

4. 常用玩法

• 问问题 / 加功能：直接描述即可，支持用 @ 模糊搜索文件，还能把图片拖进终端作为参考。
• 先规划再动手：按 Tab 切到 Plan 模式（只读，不改文件），让它给出方案后再切回 Build 模式执行。
• 撤销改动：不满意就用 /undo 回退，可多次撤销，/redo 重做。

5. 搞定

opencode

打开即可用。想个性化，可以挑主题（/themes）、改快捷键、加自定义命令等。

下一篇：Codex CLI（OpenAI 官方）。

[Windows 从零搭建 AI 编程代理]