编程语言Node.jsAI
OpenCode 命令行 AI 编程代理使用指南
一、OpenCode 是什么？ **Open Source AI Coding Agent**：开源、可自托管、可用任何大模型（Claude / OpenAI / Google / 自建本地模型）的'AI 编程代理'，以终端为主界面，同时提供桌面应用和 IDE 插件等形式。 **终端优先 TUI + 桌面应用 + IDE 插件**：你可以在终端里和它聊天、让它干活；也有桌面版（Beta），未来还会…
一、OpenCode 是什么？ **Open Source AI Coding Agent**：开源、可自托管、可用任何大模型（Claude / OpenAI / Google / 自建本地模型）的'AI 编程代理'，以终端为主界面，同时提供桌面应用和 IDE 插件等形式。 **终端优先 TUI + 桌面应用 + IDE 插件**：你可以在终端里和它聊天、让它干活；也有桌面版（Beta），未来还会…
/opencode，它就会在 GitHub Actions 里帮你分析、修 bug、开分支、提 PR。简单理解：
OpenCode 的 TUI（Terminal UI）做得相当精致：支持主题、快捷键、多窗口、文件拖拽（包括图片），还内嵌 LSP 支持。
日常典型场景：
opencode，进入 TUI：
@packages/functions/src/api/index.ts 里的鉴权是怎么实现的？在删除笔记后软删除；再写一个'最近删除'页面，可以恢复或彻底删除。/undo 回滚，甚至 /redo 重新执行。这种'在终端里聊着聊着就把活干了'的感觉，对经常用 Neovim、tmux 的开发者来说，会非常顺手。
/init 一次，它会分析你的项目结构，在根目录生成 AGENTS.md，把你的架构、编码风格、约定记下来；建议你把这个文件提交进 Git，方便后续所有会话复用。你本质上是在训练一个属于你项目的'AI 同事'，而不是每次都从零给它喂上下文。
在 GitHub 仓库里跑一条命令：
opencode github install
之后，你可以在 Issue / PR 评论里这样用：
/opencode 帮我看一下这个问题，分析一下可能原因/opencode 在修复这个 bug 时，照着 /notes 的模式，同样在 settings 里加上鉴权/opencode 帮我写个单元测试覆盖这个边界情况它在 GitHub Actions runner 中执行，可以：
还支持：
这已经把'AI 当 teammate 一起干活'这件事做得非常工程化了，而不是单纯的 IDE 插件。
OpenCode 采用了客户端/服务器架构：核心逻辑在 server 端运行，TUI 只是其中一个'前端'。
这意味着：
下面是一个典型使用流程的示意，帮助你在脑里先过一遍：
| 日常编码 | Plan 模式 | Build 模式 | GitHub/GitLab 协同 |
|---|---|---|---|
| 安装 OpenCode (install 脚本 / 包管理器) | 进入项目目录 (cd /path/to/project) | 使用模式 (用自然语言提问/写需求) | opencode github install (配置 GitHub App & workflow) |
| 配置模型密钥 (推荐先用 OpenCode Zen) | 初始化项目 (生成/更新 AGENTS.md) | Plan 还是 Build? (仅生成方案和步骤) | 在 Issue/PR 评论中写 /opencode 指令 |
| 进入项目目录 (cd /path/to/project) | 使用模式 (用自然语言提问/写需求) | 真修改文件/跑命令 (实现功能) | 在 GitHub Actions 中 (自动分析/修改/提 PR) |
| opencode 进入 TUI | Plan 还是 Build? (仅生成方案和步骤) | 审视方案 (补充需求或调整) | |
| 初始化项目 (生成/更新 AGENTS.md) | 真修改文件/跑命令 (实现功能) | 如果不符合预期 (/undo 回滚后重新调整 prompt) |
要在终端中使用 OpenCode，你需要准备两样东西：
最简单的方式是用官方安装脚本：
curl -fsSL https://opencode.ai/install | bash
也可以用包管理器：
npm install -g opencode-aibun install -g opencode-aipnpm install -g opencode-aiyarn global add opencode-aibrew install anomalyco/tap/opencodebrew install opencode 的 formula 由 Homebrew 团队维护，更新频率相对低一些。paru -S opencode-binchoco install opencodescoop install opencodenpm install -g opencode-aimise use -g github:anomalyco/opencodedocker run -it --rm ghcr.io/anomalyco/opencodeWindows 上通过 Bun 安装的支持还在开发中。你也可以直接从 Releases 页面下载二进制使用。
OpenCode 的特点之一，就是你可以配置任意 LLM 提供商的 API Key，灵活切换模型。
如果你之前没怎么折腾过 LLM 提供商，推荐先用 OpenCode Zen——这是官方经过测试和验证的精选模型列表，更省心。
配置步骤：
/connectopencode，它会让你去 opencode.ai/auth 完成登录和支付设置，然后复制 API Key；如果你想直接用别的 provider（例如 Anthropic / OpenAI / Google），也可以在 /connect 中选择对应选项，按提示填入相应的 Key。
配置好提供商之后，就可以开始在一个项目里使用 OpenCode：
cd /path/to/project opencode
进入 TUI 后，先运行：
/init
这会让 OpenCode 分析你的项目，在项目根目录生成（或更新）一个 AGENTS.md 文件，用来记录项目结构和编码模式等上下文信息。
小建议：
AGENTS.md 提交到 Git 仓库，这样团队其他成员也可以复用这份'项目记忆'，让后续会话更懂你的项目。初始化完成后，就可以让 OpenCode 帮你干活了。下面是一些典型用法。
可以让它解释你不太熟悉的代码库：
@packages/functions/src/api/index.ts 里的鉴权是怎么实现的？小技巧：
@ 来触发项目文件的模糊搜索，帮它精准定位文件。建议先让它'规划'而不是直接'开干'。
你还可以在讨论过程中直接把图片拖进终端，比如之前用过的设计稿，让它参照图片来设计页面。
等 Plan 方案聊得差不多了，再次按 Tab 切回 Build 模式，然后直接说一句：
它就会开始真刀真枪地修改代码，帮你把这个功能做出来。
对于比较明确的改动，也可以不先 Plan，直接让 Build 模式干活，例如：
关键是给足上下文和示例，减少它瞎猜的概率。
如果发现它改的不是你要的东西，可以用：
/undo
它会把改动回滚，并恢复你最初的 prompt，你可以微调之后让它再试一次。也可以用 /redo 把刚刚撤销的改动再应用回来。/undo 可以执行多次，用来连续撤销多步操作。
你和 OpenCode 的会话是可以分享给团队的：
/share/share 才会生成可访问的链接。熟悉基本用法后，你还可以把 OpenCode 打造成自己称手的工具：
/undo 回滚。一句话：
一句话：
特别适合：
暂时不太适合：
如果你是一个愿意折腾一点、想认真把'AI 当队友'而不是'当补全器'的开发者，OpenCode 是一个非常值得投入精力的工具。它把开源、Agent、终端体验和 GitHub/GitLab 工作流绑在一起，形成了一条真正'工程化'的 AI 编码路径。
不妨按上面的步骤装一个，先用 Plan 模式让它熟悉你的项目，再慢慢把一些'重复任务'交给它——你会发现，原来'让 AI 真正替你干活'，可以这么自然。
Github 地址：https://github.com/anomalyco/opencode
文档地址：https://opencode.ai/docs
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online