你会得到什么
OpenCode Claude Agent 是 OpenCode 从 v2.2.3 起内置的一个模型来源：装好 Claude Code、运行 claude auth login 登录，再在 OpenCode 的 /connect 里选 Claude Agent，就能在 OpenCode 里直接用你自己 Claude 账号里的模型，不用另外申请 API Key。这篇讲清怎么连、连上后有什么不一样，附两段可以交给 AI Agent 的提示词。
先把期望摆对：连上之后，换的只是"大脑"，干活的方式还是 OpenCode 那一套。 Claude Code 自己的设置、CLAUDE.md、技能和 MCP 都不会带过来，这一点决定了你要不要搬一下配置。
整套流程是：先装好并登录 Claude Code，再在 OpenCode 里连上 Claude Agent，选一个 Claude 模型，之后像用其他模型一样干活，工具和权限都由 OpenCode 管。
它是怎么做到的
OpenCode 通过 Anthropic 官方的 Claude Agent SDK，调用你电脑上已经装好的 claude 程序。它有三个特点：
- 不碰你的登录信息：OpenCode 不读取 Claude Code 保存的登录，只记录"你选了这种方式"。登录在终端里用
claude自己完成。 - 什么登录都行：Claude 订阅、API Key 或者云服务账号，只要 Claude Code 能用，这里就能用。
- 用的是你的额度：请求走你自己的 Claude Code，消耗的是你那个账号的用量。
第 1 步：装好 Claude Code 并登录
在终端里确认 Claude Code 已经安装、版本够新（需要 2.1.248 或以上），然后运行：
claude auth login
注意是 claude auth login，不是在 Claude Code 里输入 /login。OpenCode v2.2.4 专门修正了这个容易误导人的提示。
第 2 步：在 OpenCode 里连上 Claude Agent
在 OpenCode 里打开 /connect（桌面版在 设置（Settings）→ 模型来源（Providers）），选 Claude Agent。从 v2.2.4 起，它排在 Anthropic 后面的常用位置，选中后会先显示设置说明，而不是直接保存：
点 Connect 后，OpenCode 会先检查 claude 能不能用：
- 一切正常，就进入选模型这一步。
- 没装、没登录或者启动失败，对话框会直接告诉你原因，修好后点 Check again 重新检查。
以上截图来自 OpenCode 官方仓库的合并请求 #60603。claude 不在默认路径时，可以用环境变量 OPENCODE_CLAUDE_PATH 指定它的位置。
第 3 步：知道哪些东西不会跟过来
这是最容易踩坑的一步。为了让 OpenCode 的体验和其他模型保持一致，Claude Agent 会关掉 Claude Code 自己的很多东西：
| Claude Code 里的 | 在 OpenCode 里 |
|---|---|
| 内置工具（读写文件、跑命令） | 关掉，改用 OpenCode 的工具，权限提示也走 OpenCode |
~/.claude 和项目里的 .claude 设置、CLAUDE.md |
不读，OpenCode 读的是 AGENTS.md |
| 钩子（hooks）、MCP 服务器、技能（skills） | 不读，要在 OpenCode 里重新配 |
| 自动压缩会话、自动记忆 | 关掉，由 OpenCode 自己压缩 |
| 计划模式 | 不用，改用 OpenCode 的 Plan 代理 |
还有一个小区别：为了把每次工具调用的结果对上号，工具是一个一个依次执行的，不会并行跑。
所以如果你在 Claude Code 里积累了不少 CLAUDE.md 规矩和技能，最好让 AI Agent 帮你搬到 OpenCode 能读的地方：
这么写，是因为先列清单再动手，你能看到到底有多少东西要搬；只先搬规矩、其余逐项确认，万一搬错也容易回退；保留原文件，回到 Claude Code 时一切照旧。
第 4 步：选模型，照常干活
连上后，在 OpenCode 的模型列表里选一个 Claude 模型，用法和其他模型一样。同一个会话里可以随时换成别家的模型，历史记录的格式是统一的，切来切去不会乱。
想让 AI Agent 帮你一次检查到位，可以发这段：
帮我检查 OpenCode 里的 Claude Agent 能不能正常用：
1. 看 claude 有没有装、版本是不是 2.1.248 以上、有没有登录（只运行查看类命令，不要替我登录）
2. 看 OpenCode 是不是 v2.2.3 以上，低于这个版本先问我要不要升级
3. 都没问题的话，告诉我在 OpenCode 里点哪里连上 Claude Agent；有问题就用大白话告诉我卡在哪一步
常见问题
OpenCode 能用 Claude 订阅吗？ 能。从 v2.2.3 起，选 Claude Agent 就是用你自己 Claude Code 的登录，订阅、API Key 或云服务账号都可以。
OpenCode 和 Claude Code 选哪个？ 如果你喜欢 OpenCode 的界面、想在同一个地方切换多家模型，就用 OpenCode 加 Claude Agent。如果你重度依赖 Claude Code 自己的技能、hooks 和插件，直接用 Claude Code 更省事，因为这些在 OpenCode 里不会生效。
为什么我的 CLAUDE.md 没生效？ 这是设计如此。Claude Agent 不读 Claude Code 的任何设置文件，规矩要写进 OpenCode 读的 AGENTS.md。
连上后显示需要登录（Needs sign-in）怎么办？
在终端运行 claude auth login 重新登录，回到 OpenCode 点 Check again。桌面版也可以在设置里点 Needs sign-in 重新打开设置流程。
会额外收费吗？ OpenCode 不另外收费，用的是你 Claude 账号的额度。用量规则以你的 Claude 方案为准。
注意
- 版本要够：OpenCode v2.2.3 才有 Claude Agent，v2.2.4 才有引导式设置；Claude Code 要 2.1.248 以上。
- 配置不会自动带过来：搬之前别以为规矩还在，先检查一遍 AGENTS.md。
- 工具不会并行：一次要读很多文件时，可能比在 Claude Code 里慢一些。
- 用订阅额度走第三方界面前，留意 Anthropic 对用量和使用方式的规定；拿不准就用 API Key。
还不熟悉 OpenCode 的话，可以先看 让 AI Agent 一直干到目标完成。
评论（0）
还没有评论，来说第一句。