opencode-anthropic-auth新手安装完全指南：从克隆仓库到跑通
【免费下载链接】opencode-anthropic-auth项目地址: https://gitcode.com/GitHub_Trending/op/opencode-anthropic-auth
opencode-anthropic-auth 是一款为 OpenCode 打造的 Anthropic 认证插件，让 Claude Pro / Max 订阅用户无需额外购买 API Key，即可通过 OAuth 授权码在 OpenCode 里直接使用 Claude 大模型。本文将从克隆仓库开始，手把手带你完成安装、配置登录，直到跑通第一次对话。
一分钟看懂：opencode-anthropic-auth 是什么？
简单说，它解决了一个常见痛点：OpenCode 想用 Claude 模型，但你不想按 token 付费。
这个插件的核心思路是：借用你已有的 Claude 订阅（Pro 或 Max），走 OAuth 授权登录，把访问令牌接进 OpenCode 的请求链路中。
它自带三种登录入口，按需选择即可：
- Claude Pro/Max：走 claude.ai 的 OAuth，适合订阅用户，Token 成本自动清零
- Create an API Key：走 console.anthropic.com，OAuth 授权后一键创建 API Key
- Manually enter API Key：直接手动粘贴你自己的 API Key
插件主逻辑集中在 index.mjs，三种登录方式的定义见 index.mjs。
安装前准备：环境与依赖
在动手前，先确认本机满足以下条件，能避免 90% 的报错：
| 依赖 | 要求 | 说明 |
|---|---|---|
| 包管理器 | Bun（推荐）或 Node.js 18+ | 项目使用 ESM 与 Bun 脚本 |
| 网络 | 可访问 Anthropic 授权页 | 登录时需要跳转浏览器 |
| OpenCode | 已安装并可运行 | 插件的宿主环境 |
- 项目采用 MIT 协议，可自由安装与修改，见 LICENSE。
- 依赖清单见 package.json，锁定文件见 bun.lock，版本由 script/publish.ts 脚本管理发布。
一键安装步骤：从克隆仓库到本地运行
第 1 步：克隆仓库
打开终端，执行克隆命令，把项目拉到本地任意目录：
git clone https://gitcode.com/GitHub_Trending/op/opencode-anthropic-auth cd opencode-anthropic-auth第 2 步：安装依赖
进入目录后，安装项目依赖。推荐用 Bun，速度更快：
bun install若本机没有 Bun，用 npm 也可以：
npm install看到依赖安装完成、无红色报错，即代表第一步成功。
在 OpenCode 中启用插件
opencode-anthropic-auth 是一个 OpenCode 插件（入口导出AnthropicAuthPlugin，见 index.mjs）。将它接入 OpenCode 有两种常见方式：
- 本地目录方式：把项目目录软链接或直接放进 OpenCode 的插件目录
~/.config/opencode/plugin/，让 OpenCode 加载它。 - 包引用方式：在 OpenCode 的配置（
opencode.json）中按包名引用该插件，重启 OpenCode 即可生效。
启用后，在 OpenCode 里执行认证命令（通常是
/auth），就会看到由本插件注册的三个登录入口。
三种登录方式详解
在 OpenCode 触发认证后，会列出插件提供的三个选项（来源 index.mjs）：
- Claude Pro/Max👉 订阅用户首选。选择后浏览器打开 claude.ai 授权页，登录并授权，把回传的授权码粘贴回终端，插件即完成换 Token。
- Create an API Key👉 选择后走 console 授权页，授权成功后插件会自动帮你创建一枚 API Key。
- Manually enter API Key👉 最简单直接，直接粘贴你已有的 API Key。
整个授权采用PKCE（OAuth 2.0 安全流程），由@openauthjs/openauth生成挑战码（见 index.mjs），令牌过期后还会自动用 refresh_token 刷新（见 index.mjs），无需手动重登。
验证是否跑通
完成登录验证是否成功的两个信号：
- 模型列表正常：在 OpenCode 里选择 Anthropic 提供的 Claude 模型，能正常发起对话。
- 成本显示为 0：对订阅用户，插件会把所有模型的输入 / 输出 / 缓存成本清零（见 index.mjs），这意味着你用的是订阅额度而非按量计费。
如果对话能正常返回内容，恭喜你，插件已经跑通！🎉
常见问题 FAQ
Q：安装时报依赖错误怎么办？优先用bun install；确认 bun.lock 未被改动，必要时删除依赖目录后重装。
Q：浏览器授权后粘贴授权码仍失败？授权码有时效，过期需重新授权；确认网络能访问 Anthropic 授权页。
Q：它会影响我原有的 API Key 吗？不会。插件只在 Anthropic provider 的 OAuth 链路中工作，手动 API Key 方式保持原样。
Q：如何升级到新版本？项目通过 script/publish.ts 触发版本发布，普通用户只需重新拉取最新代码并重装依赖即可。
项目结构与关键文件
整个插件非常轻量，核心就一个入口文件：
- 插件主逻辑与三种登录方式：index.mjs
- 包信息与版本：package.json
- 依赖锁定：bun.lock
- 版本发布脚本：script/publish.ts
- 开源协议：LICENSE
掌握以上文件，你就能轻松理解 opencode-anthropic-auth 的全部行为，也方便按需二次改造。
小结：opencode-anthropic-auth 用「克隆仓库 → 安装依赖 → 启用插件 → OAuth 登录 → 跑通对话」五步，就能让 Claude 订阅用户在 OpenCode 里零成本使用 Claude 模型。照着本指南操作，新手也能一次性跑通。
【免费下载链接】opencode-anthropic-auth项目地址: https://gitcode.com/GitHub_Trending/op/opencode-anthropic-auth
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
