OpenCode 安装配置完整教程：Claude Code 和 Codex 的第三条后路

那天早上，两个 AI 编程主力同时掉了链子。

先是 Codex 突然让我重做安全验证。我愣了一会儿——它就卡在那儿，没动静。

偏偏 Claude Code 那边的账号也崩了，两个主力同时用不了，那天早上的活直接停了。

说实话，那一刻我才意识到：押着两个 AI 编程工具不叫保险，叫两个鸡蛋装一个篮子。

那次之后，我把 OpenCode 也装上了。

💬 没用过这些工具的朋友先看这里

Claude Code、Codex、OpenCode 都是装在电脑上的 AI 编程工具——你用大白话告诉它"帮我做点啥"，它就能直接动你的项目、改文件、跑命令。这篇要讲的是装哪些、为什么得装不止一个。想先搞清楚市面上都有哪些主流工具、各自适合谁，可以先看这篇AI 编程中文教程哪里找？10 大主流编程工具完整指南。

这一年我被卡过好几次，每次的解法还不一样

不是只有那一次。把这一年遇到的卡点归一归，其实就两类——而且解法完全不同。

第一类，安全验证。 工具突然要你重新验证身份，屏幕停在验证页面，动不了。这一类还算好解：把当前对话关掉、重新开一个，往往就能接着用。但代价是——上一个对话攒下的上下文、推进到一半的活，全没了，只能从头再喂一遍。

第二类，直接封号。 这一类才真折腾。账号被判异常、地区策略变了、付款方式不对——平台直接把你的号封了，任务彻底做不下去。封号没有"关掉重开"这种小修小补：只能去申请新号、重新登录配置，中间这段活全停着。而且现在各家封号都挺频繁，今天没轮到你，不代表明天不会。

两类合起来，是同一个问题：主力工具是别人的服务，不是你的家底。你押得越重，那一刻越被动。

两类卡点，解法不同，共同点都是「你说了不算」。

不是工具不好用，是少了一条后路

我主力还是 Claude Code + Codex，这俩没毛病——毛病在你只攥着这一条路。卡一次的代价你算过就知道：短则当天的活重排，长则后面几天连着补。多装一条不一样的后路，不过是花点小成本，图主力趴下那天不至于干瞪眼。

💬 我已经有 Claude Code + Codex 两家了，凭啥还要第三个？

因为它俩都是"别人的账号"，能同一天一起被卡。OpenCode 是开源的、不绑死某一家，背后接哪个模型由你定——你接的那家出问题，它能立刻换一家接着干。再开个同一家的小号没用，主力被限制它多半跟着一起趴。

装上之后，卡点变成了小插曲

再遇到 Codex 要验证，我不再干等——直接打开 OpenCode，把同一段需求贴进去，中午前那批活照样交了。没改密码、没动任何配置，就是多开一个工具而已。

从"被困在验证页面"到"换条路接着走"，这点体感差，比省下的那点时间值钱得多。

把 OpenCode 想成公司里的救火队员

我现在的工作台是这么分工的——

三个工位各干各的，不抢活。不是 OpenCode 干不了主力的活——它背后接什么模型你随便挑，真上强模型一样能扛硬仗；是你策略上让它当后路，平时不抢活、关键时刻才顶上，这样三条线才不至于哪天一起塌。

就像雇人：全押在一个人身上，他请假公司就停摆；三个人各有一把钥匙，今天谁有空谁开门。

💡 划重点

OpenCode 不是 Claude Code 或 Codex 的替代品，是第三个能独立干活的工具。它的价值不在「比别人强」，在「主力卡住时还能继续」。

按任务换模型，别让一个模型扛所有活

OpenCode 这条后路真正的红利，是你能按任务换模型——

写中文用工程模型，出来一板一眼像写报告；问点小事用主力模型，纯烧钱。把活交给对的模型，同一件事更快、更便宜、更准。

这里还藏着一个平时最实用的价值——帮你省主力的开销。真正的重活、要顶级能力的，该上贵模型还得上；但像采集点数据、分析个表格、抓个网页这种杂活，交给 OpenCode 接的便宜模型就够了，没必要回回都烧主力那点宝贵额度。主力的钱花在刀刃上，杂活让便宜模型扛。（想看便宜模型接 Claude Code 的真实省钱实测，可以参考DeepSeek V4 接入 Claude Code 的实测。）

所以这条后路不只是主力卡住那天的备胎——平时它就在帮你省钱省时间，真到主力趴下，它还是你能不能照常交活的底气。

怎么装上：手把手两条路

别被"命令行工具"吓到——OpenCode 现在有桌面客户端，新手完全可以不碰命令行。官网 opencode.ai 长这样，安装方式首页就摆出来了：

路线一：下载桌面客户端（推荐新手，全程点鼠标）

第 1 步：打开官网 opencode.ai，点右上角的 Download（或直接访问 opencode.ai/download）。

第 2 步：在下载页找到 OpenCode Desktop (Beta)，对着你的电脑选版本点 Download——

• Mac（近几年的 M 系列芯片）选 macOS (Apple Silicon)；老款 Intel 的 Mac 选 macOS (Intel)
• Windows 选 Windows (x64)
• Linux 选 .deb 或 .rpm

第 3 步：下载完像装普通软件一样双击装上、打开。

第 4 步：第一次进去会让你挑个模型——它自带几个限时免费的（DeepSeek、Nemotron 这类），随便选一个就能直接开聊，零成本先把流程跑通；手头有 ChatGPT Plus 或 GitHub Copilot 的，也能直接登录、用现成的额度。

路线二：终端命令行版（用顺了再上，更灵活）

第 1 步：先装个顺手的终端软件——我用的是 Ghostty（官方推荐里就有，去 ghostty.org 下载装上）。

第 2 步：在终端里粘贴官方安装命令、回车（下面任选一条，curl 这条最省事）：

curl -fsSL https://opencode.ai/install | bash

也可以用 npm 或 brew：npm i -g opencode-ai，或 brew install anomalyco/tap/opencode。

第 3 步：装好后，进到你要干活的项目文件夹，敲一句 opencode 启动，像聊天一样跟它说话就行。

新手别硬啃终端——先用客户端把流程跑顺、心里有底，再折腾命令行也不迟。

装完别急着开活，先把 5 件事定下来

建议存下来——这 5 件事都是我踩坑踩出来的，定下来再开工：

1. 先定"装到什么程度"。 我把它分成三条路线，新手照中间这条来最稳：

• 最小：只接通一家模型、能跑起来就行，先试个水；
• 工作台（推荐）：在"能跑"的基础上，再定好它默认在哪个文件夹干活、接一两个稳当的小工具、借用你现成的技能包——日常够用，又不会一上来把权限全开；
• 多模型：写作、工程、杂活各配一个模型，适合玩熟了想精细分工的。

2. 挑模型服务（就是给你供 AI 模型的那个服务商）。OpenCode 支持 70 多家（Anthropic、OpenAI、谷歌、本地都行），别被一家绑死；接国产中转就认准它写着"兼容 OpenAI"。密钥（连模型用的那串"钥匙"）别写进它的主设置文件，单独放、让它去那儿读——这样截图、传 GitHub 都不会泄出去。

3. MCP 别贪多。 MCP 就是给 AI 外接能力的小插件（比如查文档、连 GitHub）。先盘点主力工具已经装了哪些，挑 1-3 个低风险的复用；权限太大、要登录授权的先别开——装多了出了事，都不知道是哪个闹的。

4. Skills（技能包）只读不另存。 OpenCode 本就认 Claude Code 的技能目录，直接读那份现成的，别复制第二份（看到"重复扫描警告"别急着删目录，删错下次就崩）。还没玩过 Skill 的，可以先看这篇 Claude Code Skill 应用商店教程把技能包的概念跑通。

5. 权限默认收紧。 分享关掉，动文件 / 跑命令 / rm·sudo·git push 这类危险操作，都设成"先问你一声"，先拿不重要的目录练手。

📦 想看具体配置

每一件的具体配置——路线怎么定、密钥放哪、MCP / Skills / 权限怎么设——我整理成了完整图文，文末有入口。

装完之后，什么交给它、什么别交

适合交给它的：写作整理（改标题、压长文、整素材）、轻量工程（看配置、解释报错、写个小脚本）、主力卡住时顶上做点"只看不改"的分析。共同点——输了不致命，赢了省时间。

别交给它的：客户数据 / 私有代码、密钥 / 登录凭证（你不掌控的模型服务，尤其免费的，不一定告诉你拿你的内容干嘛）；rm·sudo·推正式分支这类危险动作；还有跨多文件的成套大改——那得靠主力"记得住超长内容"的本事，硬塞给后路只会越改越乱。

能用和不能用的边界，比"装不装"更重要。

常见问题

OpenCode 是什么？和 Claude Code、Codex 有什么区别？

OpenCode 是一个开源的命令行 AI 编程工具，同样能直接读写项目、改文件、跑命令。和 Claude Code、Codex 最大的区别是它不绑定某一家模型，背后接哪个模型由你定，所以更适合当主力之外的独立后路。

已经有 Claude Code 和 Codex 了，为什么还要装第三个？

因为它俩都依赖别人的账号，可能同一天一起被安全验证卡住或封号。OpenCode 开源、不绑死一家，你接的模型出问题能立刻换一家继续干。多一条架构不同的后路，主力趴下那天才不至于干等。

OpenCode 怎么安装？需要会命令行吗？

不需要。OpenCode 有桌面客户端，去官网 opencode.ai 下载页按系统选版本，像装普通软件一样双击安装，首次进去选个自带的限时免费模型就能开聊。想更灵活再用命令行版：终端里跑官方安装脚本，进项目目录敲 opencode 启动。

用 OpenCode 能帮我省钱吗？

能。OpenCode 支持按任务换模型：写作、工程、杂活各配一个。真正的重活上贵模型，采集数据、分析表格、抓网页这类杂活交给便宜模型就够了，不必每次都烧主力的宝贵额度。把活分给对的模型，同一件事更快更便宜。

哪些活适合交给 OpenCode，哪些不能？

适合：写作整理、轻量工程（看配置、解释报错、写小脚本）、主力卡住时做只读分析，输了不致命、赢了省时间。不适合：客户数据与私有代码、密钥凭证、rm·sudo·推正式分支这类危险动作，以及跨多文件的成套大改。

最后

AI 编程工具这两年迭代太快，今天稳明天卡，已经是常态。但你的活不能等工具稳了再做。

主力被验证卡住、甚至直接被封号的那一刻，决定你今天还能不能干活的，不是你押对了哪个工具，是你手里有没有这条后路。

只要你也靠 Claude Code 或者 Codex 吃饭、卡上一天就肉疼，我都建议你顺手把 OpenCode 也装上。

装得越多越乱是误区。少了一条后路，那天才知道有多疼。

一键复刻提示词

把下面这段完整复制，发给你的 Claude Code、Codex，或任何一个 AI 编程助手——它会带你在本机把 OpenCode 从零装到能正常干活：

你是我的 OpenCode 本机部署助手。OpenCode 是一个开源的命令行 AI 编程工具，我要在这台电脑上把它从零装到能用。你来主导，但每次动我的环境前都先跟我确认。

① 只读盘点（先别改任何东西）：看看我这台机器已经装了哪些 AI 编程工具（如 Claude Code、Codex）、各自配了哪些 MCP（给 AI 外接能力的插件）、Skills（技能包）放在哪个目录、有没有现成的模型服务和密钥，结果列给我。

② 问清楚再动手：问我——什么操作系统；想让 OpenCode 默认在哪个文件夹干活；有没有现成的模型服务（兼容 OpenAI 接口的最省事）和密钥；哪些现有 MCP 想复用；Skills 要不要直接读 Claude Code 那份现成的。

③ 给我三个方案，每个都讲清是什么：『最小』= 只接通一家模型、能跑起来就行，适合先验证能用；『工作台（推荐）』= 再定好默认工作目录、接 1-3 个低风险 MCP、直接读用现有 Skills 不另存，日常够用又不放开全部权限；『多模型』= 写作 / 工程 / 杂活各配不同模型（便宜的跑轻活、强的跑重活、省开销），适合熟手精细分工。把差别和适合谁讲清，让我选一个。

④ 按我选的方案，实际装到能用：写好配置、接好模型、装上选定的 MCP、配好 Skills 读取，最后跑个最小测试确认能正常对话、能调用工具，并告诉我怎么验证它装好了。

全程安全红线：不许动坏我现有的 Claude Code、Codex、项目说明文件（AGENTS.md、CLAUDE.md）、密钥和项目配置；密钥只走官方登录认证、单独存放、不写进主配置文件；对话分享默认关闭；动文件 / 跑命令 / 写工作目录外 / rm·sudo·git push 这类操作每次先问我；动我环境前先说要干什么、等我点头再做。

它会先盘点、再问清楚、给你三个讲明白的方案，选定后才动手装，全程动你环境前都先确认——不会一上来就乱改你的电脑。

这篇讲的是"装哪些、为什么、装之前要想清楚什么"。真正动手时的完整细节，我都整理成图文教程了——OpenCode 一步步怎么部署、模型服务 / MCP / Skills / 项目规则怎么配、装完的验收清单和安全自检，还有 Claude Code / Codex / OpenCode 三个工具怎么协同搭一套不停工的工作台，全是写好的文字，随时能翻、照着做就行。

完整图文教程收录在 AI 编程实操课，需要的可以去看。