opencode-claude-auth

技能简介

opencode-claude-auth 是一款 OpenCode 插件，它直接将 OpenCode 与你的 Claude Code 账号体系打通——无需单独申请 API Key，无需额外登录步骤，插件会自动读取 Claude Code 的 OAuth 凭证（macOS Keychain 或 JSON 凭证文件），为 OpenCode 提供 Anthropic API 的认证能力。

这意味着：如果你已经在本地使用 Claude Code 并完成认证，安装这个插件后，OpenCode 即可直接调用 Anthropic 全系列模型（支持 14 种模型，包括 claude-opus-4-7、claude-sonnet-5 等最新版本），无需任何额外配置。插件在后台自动处理凭证刷新、多账号切换和跨平台兼容，真正实现「安装即用」。

核心能力

1. 零配置认证：读取 Claude Code 现有凭证，OpenCode 开箱即用，无需申请 API Key
2. 14 种模型支持：覆盖 Claude Opus、Sonnet、Haiku 全系，包括各型号的特定版本（如 20251101、20250929 等日期版本）
3. 多账号自动检测（macOS）：自动识别 Keychain 中多个 Claude Code 账号，通过 opencode auth login 切换
4. 后台凭证刷新：30 秒内存缓存 + 5 分钟自动后台同步，凭证临近过期前自动通过 Anthropic OAuth 端点刷新，零 LLM Token 消耗
5. 跨平台兼容：macOS（Keychain 优先）、Linux（读取 ~/.claude/.credentials.json）、Windows（写入双路径确保覆盖所有安装方式）
6. 静默降级：若凭证非 OAuth 格式，插件自动降级为标准 API Key 认证逻辑
7. OpenCode 原生插件机制：无需手动 npm install，OpenCode 启动时自动通过 Bun 安装，配置写在 opencode.json 的 plugin 数组中

工作原理

opencode-claude-auth 的核心是一个自定义 Fetch Handler。当 OpenCode 向 Anthropic API 发起请求时，插件拦截这些请求，从 macOS Keychain（macOS 平台）或本地 JSON 凭证文件（Linux/Windows）中读取 OAuth Token。读取后放入内存缓存，TTL 为 30 秒，减少重复读取系统 Keychain 的开销。

后台进程每 5 分钟重新同步一次凭证。如果发现 Token 临近过期，插件直接调用 Anthropic 的 OAuth 刷新端点刷新 Token，全程不消耗任何 LLM Token。若直接刷新失败，插件回退使用 Claude CLI 进行凭证刷新。

插件还会将凭证同步写入 OpenCode 的 auth.json 作为备份（Windows 平台同时写入两个路径确保覆盖）。通过 opencode auth login 命令可以管理多个 Claude Code 账号的切换。

安装配置

前置要求

• Claude Code：已安装并在本地完成首次认证（运行一次 claude 命令）
• OpenCode：已安装
• 平台：macOS（推荐，优先使用 Keychain）、Linux 或 Windows

安装步骤

方式一：让 AI 助手完成（推荐）

将以下内容粘贴给任意 AI 编程助手（Claude Code、OpenCode、Cursor 等）：

Install the opencode-claude-auth plugin and configure it by following: https://raw.githubusercontent.com/griffinmartin/opencode-claude-auth/main/installation.md

方式二：手动配置

1. 编辑 ~/.config/opencode/opencode.json（全局配置）或项目级 opencode.json：

{
  "plugin": ["opencode-claude-auth@latest"]
}

> 使用 @latest 标签可确保 OpenCode 每次启动时自动拉取最新版本。无需手动 npm install，OpenCode 启动时通过 Bun 自动安装插件。

2. 启动 OpenCode，插件自动读取 Claude Code 凭证并生效。

多账号切换（macOS）

运行 opencode auth login，插件会自动检测 Keychain 中所有 Claude Code 账号并提供切换选项。

使用步骤

1. 确认 Claude Code 已认证：在终端运行一次 claude 命令，确保已完成首次登录
2. 安装插件：将 opencode-claude-auth@latest 加入 opencode.json 的 plugin 数组
3. 启动 OpenCode：运行 opencode，插件自动拦截 Anthropic API 请求并注入凭证
4. 验证认证：尝试让 OpenCode 调用 Claude 模型（如 claude-opus-4-7），观察是否正常响应
5. 多账号切换：需要切换账号时，运行 opencode auth login 选择目标账号

适用场景

1. 已有 Claude Code 账号，想在 OpenCode 中直接使用：无需重新申请 API Key，安装插件即可
2. 多账号管理：同时使用个人账号和团队 Claude Code 账号，通过 Keychain 多账号检测快速切换
3. 跨平台开发：在 macOS/Linux/Windows 多端协作，各平台自动适配对应凭证存储方式
4. 模型对比测试：OpenCode 中快速切换不同 Claude 模型版本，对比输出质量差异
5. API 成本控制：使用 Claude Code 订阅制账号而非按 Token 计费，在 OpenCode 中享受同等能力

适用人群

• Claude Code 用户：已在本地完成认证，希望在 OpenCode 中复用同一套凭证
• 多 AI 平台用户：同时使用 OpenCode 和 Claude Code，不想维护两套独立的 API Key
• 团队协作场景：Claude Code 账号已在团队内部分享，想在 OpenCode 中统一使用
• 模型测试工程师：需要频繁在 Claude 全系模型间切换对比效果

官方链接

• GitHub：https://github.com/griffinmartin/opencode-claude-auth
• npm：https://www.npmjs.com/package/opencode-claude-auth