opencode：跑在终端里的编码 Agent
它解决的是「让模型真的动手改这个仓库」那一类活：读代码、跑命令、打补丁、看语言服务器的诊断， 再按你设的闸门决定哪一步要先问你。这条路的代价也很清楚——它在你机器上有 shell、有写权限， 代码内容要发给模型服务商，权限放太松出事的不是模型而是你的工作区。 本专题共 40 篇，每篇都对着仓库里的真实文件写：能用的先讲怎么用与代价在哪，想改的再往下读内部机制。 项目仍在高频迭代，文中结论以 仓库最新代码与文档 为准。
opencode 是什么：终端里的开源 AI 编程 Agent 全景地图
拆解开源项目 opencode 的整体结构：它是一个 CLI 里同时跑客户端和服务端的编码 Agent，把写代码拆成了会话运行时、工具层、权限层、上下文层几块。读完你能判断它适不适合你的工作方式，也知道该先动哪个配置。本文不教配置调参，也不比较各家工具优劣。
上手与使用
先装上跑通一轮，再谈接模型、配权限、写规则文件与自定义命令、接 MCP 与 skills。
把开源编码 Agent opencode 挂到代码托管平台：权限与边界
opencode 是跑在终端里的开源编码 Agent。本文按仓库代码梳理它的 GitHub Action 与 GitLab 两条集成线：令牌从哪来、为什么要校验发起人权限、workflow 权限位怎么写、GitLab 侧要你自己补什么，以及它明确不管的事。不讲价格与额度。
给 opencode 写自定义命令：把重复指令固化成一条斜杠命令
opencode 是跑在终端里的开源 AI 编码 Agent。本文顺着它的命令加载、参数替换、shell 抓取与子代理路由读源码，讲清参数怎么传、占位符替换成什么、哪些重复动作值得固化成命令、哪些做了反而添乱，以及命令自动跑 shell 带来的风险。不覆盖插件与 MCP 开发。
开源终端 Agent 项目 opencode 的多 agent 怎么配
从 opencode 仓库源码出发，讲清一个 agent 由什么构成、权限规则表如何决定它能用哪些工具、子 agent 的模型从哪继承、主 agent 派活时子会话权限怎么推导，以及什么活值得单开一个 agent。不含安装教程，也不做产品排名。
开源终端 Agent opencode 的两条模型接入路线怎么选
opencode 自带一条由项目方维护的模型接入线（OpenCode Zen），和你自己在配置里填 API key 是并行的两条路。这篇按仓库文档与源码梳理两者各自省掉了什么、又把什么交给了别人：凭据落盘位置、模型目录从哪来、没连凭据时清单会被裁剪、小模型与数据边界，以及一份上手避坑清单。不含价格与额度，也不替你下选型结论。
开源终端 Agent opencode 的配置从哪读，改错一处为何全变
把 opencode 这个跑在终端里的开源编码 Agent 的配置装配链路拆开：全局与项目两层文件怎么发现、八级来源按什么顺序合并、{env:} 与 {file:} 两种替换发生在解析之前意味着什么、schema 校验为什么只拦顶层键、以及全局配置坏掉时为何不报错只是静默失效。不讲模型选型，不讲价格。
开源终端 Agent opencode 接 MCP：两类接法与认证避坑
从 opencode 仓库的 mcp 目录出发，讲清本地进程式与远程式两类接法的分界、OAuth 认证从 401 到令牌落盘的链路、工具名被怎样改写，以及接多个 server 后最先出问题的地方。读完能预判一份配置怎么跑、出错该看哪个文件；不解决选哪个服务、怎么写 server。
开源终端 Agent opencode 界面用熟：键位、主题与区块含义
拆解开源终端编码 Agent opencode 的 TUI：底栏与侧栏各块在报告什么、leader 键与 which-key 面板怎么让你不用背键位、主题切换与自己写一份要动哪些文件。读完能把陌生机器上的界面快速调顺手，并认清哪些操作会真改你的代码。不做产品优劣对比。
开源终端编码 Agent opencode 跑不动：按模型、认证、Windows、代理证书的顺序排查
opencode 是跑在终端里的开源编码 Agent，出问题时报错往往指不到根因。这篇按连不上模型、认证失效、Windows 路径与 WSL、代理与证书四道关的固定顺序讲排查，配上仓库里日志与存储的真实落盘位置。读完你能拿到一份可照抄的自检顺序；它不解决模型答得好不好，也不替你调优提示词。
终端 AI 编程 Agent opencode 的权限闸门怎么设
拆解开源终端编码 Agent opencode 的 permission 配置：三种动作、两级通配、最后匹配者胜的判定顺序、默认放行与默认询问的清单、always 记忆的作用范围，以及审批放太松和放太紧各自会付出什么代价。不覆盖模型选型、计费和它的其它子系统。
终端编码 Agent opencode 的 skills 用法与分工
拆开开源终端编码 Agent 项目 opencode 的技能机制：SKILL.md 放在哪六类位置会被扫到、命名与 frontmatter 的文档规则和实际校验差在哪、skill 工具加载时到底往上下文里塞了什么，以及技能与自定义命令、子 agent 的分工线。读完你能判断哪些内容值得写成技能、哪些不值得。不讲价格与额度。
终端编码 Agent opencode 命令行：交互模式与脚本化执行
拆开开源项目 opencode 的命令行入口，讲清楚不带参数进 TUI 和 opencode run 一次性执行到底差在哪：输出走 stdout 还是 stderr、权限请求在无人值守时会被怎么处理、会话怎么接续、什么时候该配 serve 常驻。不讲安装步骤，也不评价它和别的工具谁更强。
opencode 安装上手：开源终端编码 Agent 的装法与避坑
opencode 是一个跑在终端里的开源 AI 编码 Agent。这篇按仓库文档梳理它的几种安装方式各自要付出什么代价、第一次启动它要你依次做完的鉴权与初始化动作，以及新手最容易卡住的模型引用、权限默认值、日志定位三处。不讲价格额度，不替你选模型。
opencode 的诊断与格式化两条线：语言服务器怎么报错、格式化器何时跑
拆开开源终端编码 Agent opencode 的写文件后置流程：格式化命令先跑完、语言服务器再重新读盘出诊断，两条线为什么是串行而不是并行。你会拿到配置键对照、只报 error 且每文件二十条的回灌规则、多格式化器抢同一扩展名的排查方法。不涉及模型选型与提示词调优。
opencode 读哪些规则文件：终端编码 Agent 的规则加载顺序
opencode 是跑在终端里的开源编码 Agent。本文按仓库代码梳理它从哪些位置读规则文件、AGENTS.md 与 CLAUDE.md 谁盖谁、子目录规则何时才注入，以及规则写太长为什么会稀释效果。读完能拿到一份可核对的加载顺序和一份避坑清单，不讲安装与模型选型。
opencode 怎么接模型：终端编码 Agent 的供应商层与认证机制
拆解开源终端编码 Agent opencode 的模型接入机制：供应商这一层由哪些文件装配、认证方式分成哪几类、凭证落在哪里、换模型到底该改哪个键，以及接国产模型与本地模型分别要注意什么。读完你能自己定位配置不生效的原因。本篇只讲机制，不涉及各家价格、额度与限流阈值。
结构与机制
按层逐块读：会话与上下文压缩、提示词变体、工具层与各类工具、扩展面、快照回滚与多前端。
把开源终端 Agent opencode 铺给团队：策略层锁得住什么、锁不住什么
opencode 是跑在终端里的开源编码 Agent，团队铺开时真正能约束住的是配置层。这篇拆开它的 permission 权限规则、experimental.policies 资源策略、以及八级配置优先级链，讲清哪些行为能硬锁、哪些只是默认值、哪些它压根不管，并给出可照做的避坑清单。不解决计费、审计与合规取证问题。
拆解终端编码 Agent opencode：事件清单如何撑起 TUI 与插件
逐文件拆解 opencode 的事件层：事件怎么定义、对外清单怎么收窄、内核总线如何落库与重放，再经桥接层和 SSE 端点分发给 TUI、插件与外部程序。读完你能自己接一个订阅端，也能判断哪些事件不该依赖。不讲模型调用、提示词写法与价格。
开源编码 Agent opencode 找代码三件套：读取、按名找、按内容找
拆开源 AI 编码 Agent opencode（GitHub 上的 anomalyco/opencode）的三个检索工具，看它把「读文件、按名字找、按内容找」拆成三类问题分别解决，以及每个工具在返回给模型之前怎么裁剪输出。读完你能照着判断自己的 Agent 检索层该在哪里设闸门，也能知道这套设计明确不管哪些事。
开源项目 opencode 的 shell 工具：命令怎么解析、哪些会被权限层拦下
拆开跑在终端里的开源编码 Agent opencode 的 shell 工具，看它如何用语法树把一串命令拆成子命令与路径、如何拼出因 shell 而异的工具描述、又如何把结果交给权限规则裁决。读完你能自己排查某条命令为什么弹窗或不弹窗，并写出粒度合适的权限配置。不涉及部署、计费与模型选型。
开源项目 opencode 怎么把一个 Agent 内核挂上四五套界面
拆开 opencode 仓库看它的前端分层：终端、浏览器、桌面端各占独立的包，靠的是内核只认服务端接口这一条边界。读完你能拿到一张组成部分对照表、界面入口参数的真实结构，以及这套拆法放弃了什么。不解决怎么给它写插件，也不评价它和别的编码 Agent 谁更好用。
开源终端 Agent opencode 的 ACP 层拆解：重映射的代价
逐文件读 opencode 仓库的 src/acp 目录：opencode acp 起来的是什么进程、会话状态存在哪、工具调用怎么翻成编辑器画得出的卡片、权限为什么只有三档还要串行排队、批准之后为什么先写文件再回执。读完能判断这层适配放弃了什么。不做工具横评。
开源终端 Agent opencode 怎么改你的代码：覆盖、替换、打补丁三条路径的失手点
拆解开源终端编码 Agent opencode 的三种改文件方式：write 整文件覆盖、edit 按串替换、apply_patch 打补丁。讲清每条路径的匹配回退层级、护栏在哪一行代码、什么输入会让它安静地改错地方，以及权限与格式化的连带影响。不讲安装、不评测模型效果。
开源终端 Agent opencode：服务端、SDK 与会话分享
拆解开源终端编码 Agent opencode 的三块对外能力——headless 服务端、npm 上的 JS/TS SDK、会话公开分享。读完你能判断要不要把它当组件嵌进自己的系统，知道各自的接入口在哪、代价是什么。不讲提示词调优，也不讲模型效果对比。
开源终端编码 Agent 项目 opencode 的安全边界：它明说不做沙箱，你该在外面补什么
开源终端编码 Agent 项目 opencode 在 SECURITY.md 里直接写明不给 agent 做沙箱、权限系统只是 UX 功能。本文顺着仓库源码把出网、凭据、shell 执行三条暴露面拆开，讲清默认权限到底放行了什么、点一次 always 会连带批准多少，以及隔离该在工具外面怎么补。不覆盖提示注入攻防与密钥轮换流程。
开源终端编码 Agent opencode：什么时候别用它干活
opencode 是跑在终端里的开源编码 Agent。这篇不教你怎么用它，而是给一套动手前的判断顺序：一条命令能解决的别开会话、改动面太大的先拆、没有测试兜底的别放它自动跑，并如实写清权限默认值、回滚前提和会话外泄面这些能力上限。不解决模型选型与账单核算。
终端 Agent 项目 opencode 仓库结构导读：32 个包里哪些是主干，改功能从哪进
把 opencode 这个跑在终端里的开源编码 Agent 的 32 个包分成主干、契约、外壳、周边四圈，说清 opencode 与 core 怎么分工、schema 到 server 的单向依赖为什么绕不过去，以及改工具、改提示词、改界面各该从哪个目录进去。不教你怎么用它写业务代码，也不做同类项目排名。
终端编码 Agent opencode 的语言服务器集成：拉起、诊断回灌与失效表现
拆开开源终端编码 Agent opencode 的 LSP 这一层，讲清它按什么规则给每个文件挑语言服务器、诊断经过哪几道过滤才进到模型看得见的工具输出里、以及这层静默失效时 Agent 会表现成什么样。给的是机制与排查路径，不是配置速查表，也不替你判断该不该开。
Agent 改坏了代码怎么退回去：opencode 的快照与回滚机制，和你自己 git commit 的边界
opencode 在 Agent 执行的前后，用一个放在你仓库之外的影子 git 目录记录工作区状态，再按文件或按整棵树把改动退回去。本文顺着 snapshot、session/revert、git、worktree 四个模块，讲清快照怎么攒出来、回滚走的是哪条路径、它和你自己的 git commit 各自管什么，以及哪些文件它根本不碰。不讲价格，不讲版本差异。
opencode 的 code mode 支线：让模型写程序串工具的代价
拆解开源终端编码 Agent opencode 的 code mode：模型不再一次调一个工具，而是写一段受限 JavaScript 把 MCP 工具串起来执行。读完能知道这条支线由哪些文件组成、语言面砍掉了什么、权限与取消怎么落地，以及它明确不管的事。不解决选型排名。
opencode 的 plan 模式在拦什么：模式切换本质是改工具可用面
拆开开源终端编码 Agent 项目 opencode 的 plan 模式：计划代理的权限集怎么把工具从请求里摘掉、进入与退出各自那段提示词落在哪一环、plan_exit 被调用后到底发生了什么。读完你能自己判断一套模式切换是真约束还是嘴上约束，也知道它明确不管哪些风险。
opencode 工具层拆解：实现与描述分家，注册表决定模型看见什么
这篇按 opencode 仓库源码梳理它的工具层：执行逻辑写在 .ts、给模型看的说明书单独放在同名 .txt，注册表启动时装配内置与自定义工具，再在每一轮按模型、供应商、实验开关和权限规则裁剪出真正暴露的清单。读完你能定位到文件去改，也能看懂某个工具为什么没出现。不讲价格与配额。
opencode 会话全流程：消息组织、单轮步骤与中断重试的落点
拆解开源终端编码 Agent opencode 的一次会话：会话行、消息、部件三层怎么组织，一轮循环从重读历史到发起请求走了哪几步，中断、重试、溢出压缩分别落在哪一层代码。读完你能定位问题该看哪个文件，不解决模型选型、价格与部署运维。
opencode 会话数据存在哪：本地存储层与同步层是怎么拆开的
拆开开源终端编码 Agent 项目 opencode 的存储侧：SQLite 库文件放在哪、遗留的 JSON 目录还剩什么、事件表与序列号如何支撑换机器接着聊，以及这套设计带来的隐私暴露面和排查手法。不讲模型能力，也不讲提示词工程。
opencode 开源终端编码 Agent 拆解：服务端分离、双主智能体与权限规则
把 opencode 这个开源终端编码 Agent 的仓库读一遍，讲清它为什么把服务端和终端界面拆成两半、build 与 plan 两个主智能体各自管什么、permission 三态规则怎么写才不会反过来坑自己，并用四个本地开源仓库做设计取向对照。不排座次，不谈价格额度，也不替你决定生产仓库里该不该放开 bash。
opencode 扩展指南：插件钩子与自定义工具，两条路怎么选
opencode 这个跑在终端里的开源编码 Agent 有两套扩展入口，插件挂在生命周期钩子上改流程，自定义工具直接进工具表加能力。这篇从仓库里的加载器与工具注册表出发，讲清两条路各自的落点、命名规则、失败模式与边界，帮你选对入口少写代码。不讲模型调优，也不讲价格与额度。
opencode 上下文压缩拆解：压缩与溢出是两条线，压完之后你会丢什么
从 opencode 这个终端编码 Agent 的源码出发，拆开它处理上下文接近上限的两条路径——主动预判触发的压缩，和请求真的被服务端拒绝后的溢出兜底。讲清压缩那一轮用的是哪份单独的提示词、摘要按什么模板生成、哪些内容被逐字保留、哪些被永久替换掉，以及 prune 这把默认关着的刀会改动什么。不讲怎么给它配模型和装插件。
opencode 为什么备了 14 份系统提示词：开源终端编码 Agent 的提示词分家现实
拆开源终端编码 Agent 项目 opencode 的 session/prompt 目录：14 份提示词按模型家族和运行模式分家，选哪份由一个 if 链决定。读完你能看懂它的路由顺序、家族之间到底差在哪、自定义 agent 会覆盖掉什么，以及这套设计放弃了什么。不讲怎么写好一份提示词，只讲一份提示词该分几份。
opencode 怎么把活派给子 agent：task 工具与探索型子代理
拆解开源终端编码 Agent 项目 opencode 的多 agent 入口。读完你会知道 task 工具收了哪些参数、子会话的权限如何从父会话推导、探索型子代理为什么用另一份系统提示词、后台模式的实验开关在哪，以及哪些场景派活反而更慢。不讲安装配置，也不讲它与其它工具的优劣排序。
opencode 怎么住进编辑器：扩展只是启动器，Agent 还在终端
拆开开源编码 Agent 项目 opencode 的编辑器集成：VS Code 扩展在做什么、主程序靠哪两个环境变量认出编辑器、ACP 又是另一条路。读完你能判断该用扩展、终端还是 ACP，以及各自的风险面在哪。不讲怎么写提示词，也不评测模型效果。
想把 AI 编程从「能用」推到「敢放手」？
从工具选型到权限边界、验收标准，站内有成体系的教程与课程。