opencode 终端AI编码助手

learn 索引

主题定位

这是一份按帕累托法则组织的 opencode 上手教程:opencode 是一个跑在终端里的开源 AI 编码代理(TUI + CLI),支持 75+ 家模型供应商。本教程优先掌握 20% 的核心操作——安装、配置供应商、启动会话、常用命令与快捷键,应对 80% 的日常编码场景。

版本基准:本教程基于本机实测的 opencode 1.17.18(npm 包 opencode-ai)。命令与选项均来自本机 --help 核验;TUI 快捷键部分来自官方 keybinds 文档,完整清单以 TUI 内 ? 帮助面板为准。

Notes

适合场景

  • 想在终端里用 AI 直接读代码、改代码、跑命令,而不切到网页或 IDE 插件。
  • 需要一个能接多家模型(Anthropic、OpenAI、本地 Ollama 等)的统一编码代理。
  • 希望脚本化调用 AI(opencode run "...")接入 CI 或自动化流程。
  • 想在某个 Git 仓库里做多轮会话式重构、排障、写测试。

关联主题

此文件夹下有2条笔记。