详细文字内容
先复制这段短提示词
你是我的 OpenCode CLI 部署助手。请在不破坏现有 Claude Code、Codex、AGENTS.md/CLAUDE.md、密钥和项目配置的前提下，先做只读环境盘点，尤其要分析我现有 Claude Code / Codex 的 MCP 和 Skills。然后问我 6 个问题：系统和终端、默认工作目录、已有 provider 或 coding plan、是否已有 key、哪些 MCP 要复用或新增、Skills 想复用哪里。再给出“最小 CLI / 工作台 CLI / 多模型”三个方案，等我确认后再安装配置。默认推荐 OpenCode CLI；密钥只通过 /connect、opencode auth login 或官方认证输入；share 默认 disabled，权限默认保守。完整细则请读取交付/部署总控-OpenCode-CLI-Deploy-Master-Prompt.md。
这段就够你启动部署对话。它的作用不是把所有细节一次性塞给 Agent，而是先让 Agent 按正确顺序问问题、出方案、等你确认，再动本机配置。完整部署提示词已经放在 交付/部署总控-OpenCode-CLI-Deploy-Master-Prompt.md，需要全自动部署时再复制那份。
这篇课解决什么
我现在建议你多装一个 OpenCode，不是因为 Claude Code 或 Codex 不好用，而是因为真实工作里你不能只押一个入口。
Codex 做工程执行很稳，但有些任务会被安全验证、登录状态、权限交互卡住。Claude Code 是主力长会话，但账号、额度、风控、地区策略都会变化。写作、整理、轻量配置排查这类任务，也不一定非要用主力工具承接。
OpenCode 的价值在于：它是第三个 agent CLI。它可以和 Claude Code、Codex 并行存在，单独配置 provider、model、MCP、权限和项目规则。你不需要频繁改主力工具配置，就能给写作、轻任务、备用执行、多模型试验留一个出口。
先认几个词
下面这些词后面会反复出现，先记个大概就行，不用背：
三个工具怎么分工
我的推荐分工是：
Claude Code 主力长会话。适合复杂项目理解、长期上下文、重构、体系化开发。 Codex 工程执行入口。适合改代码、跑测试、做审查、处理 OpenAI 生态任务。 OpenCode CLI 第三终端。适合多模型接入、写作整理、配置排查、轻量任务、备用执行。
不要把 OpenCode 当成 Claude Code 或 Codex 的替代品。它最适合做补位：主力工具被验证卡住、账号出问题、模型不适合中文写作、或者你只是想让一个低成本模型跑轻任务时，用 OpenCode 接走这部分工作。
先选部署路线
如果你只是第一次安装，先选最小路线：
最小 CLI 安装 OpenCode CLI 用 /connect 或 opencode auth login 接一个 provider 固定一个 op 快捷入口 share disabled 权限保守 暂不启用 MCP 和 Skills
如果你已经熟悉 Claude Code / Codex，想让 OpenCode 进入日常工作流，选工作台路线：
工作台 CLI 固定默认工作目录 建立或兼容 AGENTS.md 配置 provider / model / small_model 启用 1-3 个低风险 MCP 复用已有 Skills，但不复制第二份
如果你明确想做多模型分工，选多模型路线：
多模型 写作模型：中文表达、整理、改稿 工程模型：代码修改、排错、配置 小模型：总结、分类、轻任务 本地模型：隐私任务或离线试验
多数会员从“工作台 CLI”开始最合适。它比最小路线更实用，又不会一上来把 MCP、权限、provider 全部铺满。
部署时用哪份文件
你不需要一次性复制所有文件。先用完整部署提示词启动安装；遇到具体配置问题时，再打开对应文件。
部署总控-OpenCode-CLI-Deploy-Master-Prompt.md 完整部署提示词。你要让 Agent 从安装到验收全程带跑，就复制这份。 需求分流-Use-Case-Routing.md 不确定自己需要最小部署、工作台部署还是多模型部署时用。 模型接入-Provider-Model-Setup.md 模型连不上、baseURL 不确定、provider/model/small_model 分不清时用。 工具接入-MCP-Setup.md 想启用 MCP 时用。它会先做风险分级，不会默认装一堆工具。 项目规则-AGENTS-Project-Rules.md 需要给项目补 AGENTS.md，或者兼容已有 CLAUDE.md 时用。 技能复用-Skills-Reuse-Strategy.md 需要复用 Claude Code / Codex 的 Skills 时用。重点是不要复制第二份大型 Skills。 部署验收-Deployment-Validation-Prompts.md 安装完成后，用来验证 CLI、provider、MCP、项目规则、权限和安全边界。 安全自检-Security-Checklist.md 部署完成后检查权限、分享、密钥泄露和配置覆盖风险。 配置模板-opencode-json-Config-Template.md 手写 opencode.json 时用。默认先走 /connect 或 opencode auth login，不建议一开始手写复杂配置。 界面模板-tui-json-TUI-Template.md 需要调整 TUI 偏好时用。 MCP模板-mcp-config-MCP-Template.md MCP 配置片段模板。
一般顺序是：先复制 部署总控-OpenCode-CLI-Deploy-Master-Prompt.md，让 Agent 带你完成方案确认和安装；装完以后，再用 部署验收-Deployment-Validation-Prompts.md 做检查。
provider 怎么选
OpenCode 的优势是 provider 可以独立配置。这里不要先纠结“哪个模型最好”，先看你有没有稳定的模型入口。
如果你只是轻量试用，可以先接自己已经有 key 的服务。
如果你后面确实会频繁写代码、改配置、跑多模型任务，可以考虑订阅一个大厂的 coding plan，比如字节、阿里、腾讯等提供的 coding / 模型服务入口。这样做的好处不是押注某一个模型，而是以后在不同模型之间切换更方便，也更适合把 OpenCode 当成第三终端长期使用。
先用一个入口跑通，再逐步增加模型。不要一开始把所有 provider 都接进去，否则后面排查 baseURL、model id、权限和账单都会变复杂。
这里要分清两个概念：
provider 解决怎么连接服务。 model 解决具体调用哪个模型。 small_model 解决轻任务、标题、总结、分类这类低成本任务。
如果你订阅的 coding plan 或模型服务支持 /connect 或 opencode auth login，就优先走 OpenCode 官方认证流程。不要把 key 发给 Agent，也不要把 key 写进课程文档、截图、聊天记录。
MCP 不要一次装太多
MCP 是工具扩展，不是装得越多越好。每多一个 MCP，就多一份上下文成本和权限边界。
正确做法不是让你凭空选，而是先让 Agent 看你现在 Claude Code 和 Codex 已经装了什么 MCP，再把它们分成三类：
可直接复用 已经稳定、低风险、和 OpenCode 任务强相关。 建议新增 现有工具栈没有，但 OpenCode 日常部署确实需要。 暂不启用 高权限、需要 OAuth、账号后台、云盘、cookie、全盘文件访问，或者只是偶尔用。
第一轮最多启用 1-3 个：
文档检索 查 API、库文档、官方说明。 GitHub 看仓库、issue、PR。 浏览器测试 只用于 localhost 或无登录态页面。
云盘、账号后台、支付后台、OAuth 高权限工具，不要默认启用。等你确认 OpenCode 真的需要这类能力，再单独配置。
Skills 怎么处理
如果你已经有 Claude Code Skills，OpenCode 这边不要复制第二份。尤其技能库很大时，复制会带来重复、不同步和占空间的问题。
部署前应该先让 Agent 盘点现有 Skills 路径，比如 Claude Code 的主库、Codex 的兼容目录、OpenCode 可能读取的目录。然后再让你决定复用方式。
更合理的方案通常是：
方案 A：暂不接 Skills 先跑通 OpenCode CLI、provider 和 MCP。 方案 B：复用 Claude Code Skills 主库 适合你已经有成熟 Skills，优先 zero-copy / symlink / 只读引用。 方案 C：只接少量必要 Skills 适合担心重复扫描、启动变慢或目录过大。
如果出现 duplicate warning，先检查是不是多个兼容路径被同时扫描，不要直接删目录。
权限和分享默认保守
OpenCode 是备用入口，不应该一上来给全权限。
默认建议：
share disabled permission edit: ask bash: ask external directory write: ask rm / sudo / git push: deny 或强确认
如果你要让它改真实项目，也先从一个低风险目录试。确定 provider、MCP、规则文件都稳定以后，再把它放进高价值工作流。
安装完成后怎么用
我建议你给 OpenCode 固定一个短命令，比如 op。这个命令只做一件事：进入你的默认工作目录，然后启动 OpenCode。
这样你每次打开 OpenCode，项目规则、上下文、权限边界都是稳定的。不要今天在下载目录启动，明天在桌面启动，后天又在仓库根目录启动。
安装后可以先跑三类任务：
写作整理 整理素材、改标题、压缩长文、生成发布检查清单。 轻量工程 看配置、解释报错、生成小脚本、检查文档引用。 备用执行 当 Claude Code / Codex 被验证或账号状态卡住时，先让 OpenCode 做只读分析或低风险改动。
安装完成后，先用 部署验收-Deployment-Validation-Prompts.md 做验收。确认入口、provider、MCP、权限都稳定以后，再把 OpenCode 放进日常工作流。
最后验收什么
部署完成后，不要只看能不能打开。至少确认这些点：
opencode --version 正常 op 快捷入口能进入默认工作目录 provider/model 命中预期 share 是 disabled permission 不是未确认的全 allow MCP 只启用了确认过的工具 AGENTS.md / CLAUDE.md 没有被覆盖 没有打印任何 key、token、auth、mcp-auth、cookie、.env
验收通过以后，OpenCode 才算真正进入你的工具栈。它不是主力替代品，而是第三终端：在主力工具之外，给你留一条独立、低耦合、可切模型的后路。
资源下载：
📎 OpenCode部署提示词包.zip
配套资源包下载
本课用到的全部部署提示词、配置模板和 MCP 模板都打包好了，整包下载（解压后先读 CLAUDE.md / AGENTS.md 了解阅读顺序）：
📊 本页表格（1 张，从原数据库还原）
| 词 | 一句话解释 |
|---|---|
| CLI | 在终端（黑色命令行窗口）里敲命令来用的工具 |
| provider | 模型服务商——你从哪一家接入 AI（比如某个大厂的 coding plan） |
| model | 具体调用哪个模型 |
| small_model | 小模型，专门跑起标题、做总结这类轻活，更省钱 |
| MCP | 给 AI 外接工具的协议，让它能查文档、连 GitHub、开浏览器 |
| Skills | 技能包，一套可复用的预设能力 |
| AGENTS.md | 项目规则文件，告诉 AI 这个项目该怎么干活 |
| baseURL | 模型服务的接口地址 |
| share | 会话分享开关 |
| permission | 权限设置，控制 AI 能不能改文件、跑命令 |