不再购买昂贵API key!opencode-claude-auth完全指南:用Claude Code订阅直接驱动OpenCode 【免费下载链接】opencode-claude-authOpenCode plugin that uses your existing Claude Code credentials — no separate login needed.项目地址https://gitcode.com/gh_mirrors/op/opencode-claude-auth点击查看免费下载opencode-claude-auth是一个 OpenCode 插件它直接复用你已有的Claude Code 凭证OAuth 令牌让你在 OpenCode 中免费使用 Claude 系列模型无需单独登录、无需购买 API key。本文带你从零完成安装与配置。什么是 opencode-claude-auth简单说它解决的是一个很实际的痛点传统方式使用本插件后购买 Anthropic API key按 token 付费复用 Claude Pro / Max 订阅的凭证OpenCode 与 Claude Code 各登录一次只登录一次 Claude Code手动管理 API key令牌自动刷新、自动同步如果你已经订阅了 Claude Pro / Max 并在使用 Claude Code装好这个插件后OpenCode 会自动读取你本机的 Claude Code 凭证完成认证——整个过程你只需要运行 OpenCode这一件事。工作原理它是怎么偷来凭证的别担心凭证始终只留在你的本机。插件的工作方式可以概括为四步拦截请求插件向 OpenCode 注册一个自定义 auth provider拦截所有发往 Anthropic API 的请求读取凭证从 macOS 钥匙串Keychain读取Claude Code-credentials条目其他平台则回退读取~/.claude/.credentials.json凭证文件自动刷新令牌快过期时直接调用 Anthropic 的 OAuth 端点刷新——不消耗任何 LLM token失败时回退到claudeCLI后台同步每 5 分钟将凭证同步到 OpenCode 的auth.json作为兜底令牌剩余 1 小时到期前会主动刷新一次。核心逻辑位于 src/index.ts请求拦截与刷新和 src/credentials.ts凭证读取与缓存想深入了解可配合 src/keychain.tsKeychain 读取一起看。安装前准备确认两个前提条件开始安装前请确认以下两项都已就绪✅Claude Code 已安装并完成过认证在终端运行一次claude并登录凭证就会存入 KeychainmacOS或~/.claude/.credentials.jsonLinux / Windows✅OpenCode 已安装运行opencode --version能输出版本号即可。 平台兼容性macOS 体验最佳走 KeychainLinux 和 Windows 通过凭证文件回退同样可用。一键安装步骤只需一行配置方式 A让 AI 帮你装最省事把下面这句话粘贴给任意 LLM agentClaude 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方式 B手动配置只需 30 秒打开 OpenCode 配置文件~/.config/opencode/opencode.json添加一行插件声明{ plugin: [opencode-claude-authlatest] }两个要点latest标签保证每次启动时都拉取最新版本无需手动npm install——OpenCode 会用 Bun 自动安装 npm 插件配置完成后直接运行 OpenCode插件会自动接管认证无需任何额外操作。详细的分步安装说明含验证与升级方法见 installation.md完整项目介绍见 README.md。支持哪些模型当前版本支持14 个 Claude 模型覆盖 Opus、Sonnet、Haiku、Fable 全系列系列支持型号Claude Fableclaude-fable-5、claude-fable-5-1Claude Opusclaude-opus-4-5 / 4-6 / 4-7 / 4-8 / opus-5Claude Sonnetclaude-sonnet-4-5 / 4-6 / sonnet-5Claude Haikuclaude-haiku-4-5各模型对应的 beta 标志与请求头策略定义在 src/model-config.ts可通过pnpm run test:models用你自己的账号实测验证最近一次的 14 个模型冒烟测试结果全部通过见 test-results/model-smoke-test.json。此外1M 超长上下文已被原生支持插件不再发送旧的 beta 头。如果你的套餐不含长上下文计费超出标准窗口后会提示 Extra usage is required for long context requests。多账号切换macOS 用户福音在 macOS 上登录了多个 Claude Code 账号插件会自动从 Keychain 检测所有账号并按订阅等级Claude Pro、Claude Max 等自动标注。切换方法opencode auth login在列表中选择Switch Claude Code account挑一个账号即可。你的选择会跨会话持久化如果只有一个账号切换菜单会自动隐藏。常见问题排查遇到报错别慌对照下面这张表基本都能解决问题解决办法Credentials not found先运行claude完成 Claude Code 认证Keychain is locked执行security unlock-keychain ~/Library/Keychains/login.keychain-db解锁Token expired and refresh failed插件会尝试自动刷新仍失败就重新运行claude登录Linux / Windows 不工作确认~/.claude/.credentials.json存在或$CLAUDE_CONFIG_DIR/.credentials.json运行claude生成Keychain 访问被拒绝在 macOS 弹窗中点击允许插件没有更新到最新版删除缓存~/.cache/opencode/packages/opencode-claude-authlatest/后重启 OpenCode如果认证错误难以复现可以开启诊断日志export CLAUDE_AUTH_DEBUG1日志会写入~/.local/share/opencode/claude-auth-debug.log所有密钥token、API key都会被自动脱敏文件可以直接贴到 issue 里。排查完记得unset CLAUDE_AUTH_DEBUG。进阶常用环境变量Anthropic 若调整了接口细节你不用干等插件发版——大部分参数都可以通过环境变量即时覆盖变量作用默认值ANTHROPIC_CLI_VERSION请求中的 CLI 版本号user-agent 与计费头见 model-config 中的ccVersionANTHROPIC_BETA_FLAGS逗号分隔的 beta 功能标志列表内置baseBetasANTHROPIC_USER_AGENT完整 User-Agent 字符串claude-cli/{version} (external, sdk-cli)CLAUDE_AUTH_DEBUG诊断日志开关1或自定义路径关闭CLAUDE_CONFIG_DIR凭证文件回退读取目录~/.claudeOPENCODE_CLAUDE_AUTH_MAX_RETRY_MS等待 429/529retry-after的上限30000例如临时指定 CLI 版本export ANTHROPIC_CLI_VERSION2.2.0。另外如果你已经在跑CLIProxyAPI它本身就能用 OAuth 登录 Claude 账号并暴露本地 API此时不需要也不建议再叠加本插件两者二选一即可直接让 OpenCode 内置的 Anthropic provider 指向代理地址就行。⚠️ 风险与合规提醒有一点必须坦诚说明Anthropic 的服务条款要求 Claude Pro/Max 订阅令牌仅用于官方客户端。本插件属于社区 workaround如果 Anthropic 调整其 OAuth 基础设施插件可能随时失效。请自行评估后使用并遵守你所在平台的合规要求。结语回顾一下 opencode-claude-auth 带给你的核心价值省钱不购买 API key复用已付费的 Claude Code 订阅⚡省事一行配置完成安装令牌自动读取、自动刷新、自动同步多账号macOS 下自动检测 Keychain 中的所有 Claude Code 账号一条命令切换可观测脱敏诊断日志 丰富的环境变量覆盖出问题好排查。安装完成后运行 OpenCode 即可直接开聊——你的 Claude 订阅现在同时驱动两个工具了。版本演进历史可查阅 CHANGELOG.md构建与脚本定义见 Makefile。赞分享【免费下载链接】opencode-claude-authOpenCode plugin that uses your existing Claude Code credentials — no separate login needed.项目地址https://gitcode.com/gh_mirrors/op/opencode-claude-auth点击查看免费下载相关推荐OpenCode 如何订阅 OpenCode Go 并在 TUI 中连接 API Key 使用OpenCode 如何订阅 OpenCode Go 并在 TUI 中连接 API Key 使用 OpenCode Go 是 OpenCode 提供的一项 $10人工智能AI 应用AI Agent代码智能体CLI开发者工具Repowise claude_cli Provider 实战指南用 Claude 订阅免 API Key 驱动代码库 Wiki 生成Repowise claude_cli Provider 实战指南用 Claude 订阅免 API Key 驱动代码库 Wiki 生成 本指南讲解 RepowCCX 客户端接入指南Claude Code / Claude Desktop / Codex / OpenCode 统一配置手册CCX 客户端接入指南Claude Code / Claude Desktop / Codex / OpenCode 统一配置手册 本篇技术指南以 客户端接入API网关LLM 网关后端创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考