griffinmartin/opencode-claude-auth

What it solves

이 프로젝트는 OpenCode 사용자가 기존의 Claude Code 인증 정보를 사용하여 Anthropic API와 인증할 수 있는 방법을 제공합니다. 별도의 API 키나 수동 로그인 프로세스가 필요하지 않도록 사용자의 시스템에 이미 저장된 OAuth 토큰을 활용합니다.

How it works

이 플러그인은 OpenCode를 위한 인증 제공자 역할을 합니다. Anthropic API 요청을 가로채고 필요한 OAuth 토큰을 첨부합니다. 이러한 토큰은 macOS Keychain 또는 Linux 및 Windows의 로컬 인증 정보 파일에서 가져옵니다.

세션을 활성 상태로 유지하기 위해, 플러그인은 토큰 갱신을 자동으로 처리합니다. 먼저 Anthropic의 OAuth 엔드포인트를 통해 직접 갱신을 시도하고, 필요한 경우 claude CLI를 호출하는 방식으로 대체합니다. macOS에서는 구독 티어에 따라 여러 개의 인증된 Claude Code 계정을 감지지하고 전환할 수 있습니다.

Who it’s for

이미 머신에 Claude Code가 설치되어 있고 인증되어 있으며, 별도의 API 키를 관리할 필요 없이 원활한 싱글 사인온(SSO) 경험을 것을 원하는 OpenCode 사용자.

Highlights

• Automatic Credential Discovery: macOS Keychain 또는 ~/.claude/.credentials.json에서 토큰을 자동으로 찾습니다.
• Zero-Config Setup: 설치 후, 백그라운드에서 인증 및 토큰 갱신을 처리합니다.
• Multi-Account Support: macOS에서 여러 Claude Code 계정을 감지하고 opencode auth login을 통해 전환을 허용합니다.
• Direct OAuth Refresh: LLM 토큰 소모를 피하기 위해 API 호출을 통해 토큰을 갱신합니다.
• Robust Error Handling: 속도 제한(429)에 대한 지수 백오프(exponential backoff)를 구현하고 만료된 토큰(401)에 대한 자동 복구를 구현합니다.