heymaaz/opencode-claude-auth-v2 — explained in plain English
Analysis updated 2026-05-18
Use an existing Claude Code Pro or Max subscription inside the OpenCode 2 coding assistant without a separate API key.
Run OpenCode 1 and OpenCode 2 side by side with isolated configurations.
Automatically refresh and reuse Claude Code's saved login credentials across sessions.
| heymaaz/opencode-claude-auth-v2 | 0xradioac7iv/tempfs | 52191314/web-agent-proxy-sdk | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 3/5 | 3/5 | 4/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Node.js 22+, an active Claude Code login, and a Claude Pro or Max subscription, unofficial and may break with Anthropic changes.
This project is a plugin for OpenCode 2, a coding assistant tool, that lets you sign in using an existing Claude Code Pro or Max subscription instead of setting up a separate login. It is a fork of an earlier plugin built for OpenCode 1, updated to work with the newer OpenCode 2 beta. Normally, connecting an AI coding tool to Claude requires its own API key and billing setup. This plugin instead looks for credentials that Claude Code already saved on your computer, either in the macOS Keychain or in a local credentials file, and reuses them. It sets up a separate provider inside OpenCode called Claude Subscription, so your regular Anthropic API key settings are left untouched and the two methods do not interfere with each other. Once connected, the plugin routes your requests through to Anthropic using the format that subscription-based authentication requires, refreshes your login token automatically before it expires, and keeps OpenCode's own tool permissions and workflow intact. The author explains this approach was necessary because a different community-made connector runs its own separate agent system that does not let OpenCode's own tools work properly, so this plugin was built to work directly with OpenCode's existing tool loop instead. To use it, you need Node.js 22 or newer, the Claude Code tool installed and signed in on your machine, and an active Claude Pro or Max subscription. Setup involves adding the plugin's name to your OpenCode 2 configuration file, restarting OpenCode, then running a connect command and choosing to import your Claude Code subscription. The project includes instructions for running OpenCode 1 and OpenCode 2 side by side without conflicts. The author notes this is an unofficial, community-built project. Anthropic's own documentation states that using a Claude Pro or Max subscription through third-party plugins like this is not officially permitted, so it may stop working if Anthropic changes how its login system works, and anyone using it should do so at their own discretion.
An unofficial OpenCode 2 plugin that lets you reuse your existing Claude Code Pro or Max subscription login instead of setting up separate API billing.
Mainly TypeScript. The stack also includes TypeScript, Node.js, OpenCode.
MIT license, use, modify, and distribute freely including commercially, with attribution.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.