OpenCode と Claude CLI の認証を同期するツール(opencode-claude-auth-sync)
概要
opencode-claude-auth-sync は、Anthropic の Claude CLI で既に持っている認証情報(鍵やトークン)を OpenCode に同期し、OpenCode 側で別途 Anthropic ログインを行うことなく Claude モデルを利用できるようにする小さなツールです。OpenCode は公式にネイティブな Anthropic 認証サポートを取り下げたため、Claude CLI のサブスクリプションを活用したい場合にこのツールが推奨されています。実行はシェルスクリプト/PowerShell スクリプトで行い、余計な npm パッケージをインストールせずに済む点を重視しています。README にもある通り、未知の npm パッケージを介する代替手段より安全性を優先した設計です。(約300字)
リポジトリの統計情報
- スター数: 26
- フォーク数: 5
- ウォッチャー数: 26
- コミット数: 30
- ファイル数: 9
- メインの言語: Shell
主な特徴
- Claude CLI の既存認証情報を OpenCode に同期し、別途 Anthropic ログインを不要にする。
- シェル(install.sh)と PowerShell(install.ps1)のインストーラを提供し、クロスプラットフォーム対応を容易にする。
- npm 等の第三者パッケージに頼らない設計で、未知のパッケージ導入によるセキュリティリスクを避ける。
- シンプルで最小限の依存・ファイル操作に留め、既存環境への導入負荷を低減。
技術的なポイント
このプロジェクトは「既存の CLI 認証情報を別サービスに安全に流用する」という狭い目的に特化しており、そのための設計判断がいくつか見られます。まず、インストールと同期処理はシェルスクリプトと PowerShell スクリプトで提供されており、追加のランタイム依存を減らしています。これにより、Linux/macOS/Windows(PowerShell)いずれの環境でも導入が容易です。実装面では、一般的に次のような処理を行うことが想定されます:Claude CLI が管理する既存の認証ファイルや環境変数からトークンを読み取り、OpenCode が期待する形式(設定ファイルや環境変数)へ安全に書き込む。書き込み時にはファイル権限や既存値の上書き可否をチェックし、冪等性(同じ処理を複数回実行しても問題が起きない)を保つことが重要です。
セキュリティ面の配慮も明示的で、README にある通り未知の npm パッケージを避ける方針は、実行後に機密トークンがどこへ送られるか分からないリスクを低減します。スクリプト自体はトークンを標準出力へ出したり、ネットワーク越しに送信したりしないことが望ましく、実際に配布されているコードもファイル読み書きに限定している想定です。エラーハンドリングとしては、Claude CLI の存在チェック、認証情報が見つからない場合のユーザ向けメッセージ、OpenCode 側の既存設定のバックアップ提示などが実装されていると利便性・安全性が高まります。
運用面では、この種の同期ツールは OpenCode が将来再びネイティブ Anthropic 認証をサポートする場合や、Claude CLI の認証フォーマットが更新された場合にメンテナンスが必要になります。そのため、スクリプトは小さく読みやすい形にしてコミュニティで修正しやすくしておくのが実用的です。ライセンスや README からも、導入前にコードをレビューして安全性を確認することが推奨されている点がうかがえます。(約700〜900字相当の技術解説)
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- LICENSE: file
- README.md: file
- install.ps1: file
- install.sh: file
…他 4 ファイル
上記の通り、ファイル数は少なく用途が明確です。install.sh と install.ps1 がインストール/同期のエントリポイントになっており、その他には実際の同期処理スクリプト、簡単なユーティリティ、設定テンプレートが含まれている想定です。コード量が少ないためレビューや自己ホスティングが容易で、企業や個人で内部監査を行ってから導入できます。
使い方(概要)
- 前提:Claude CLI の認証情報が既に環境に設定されていること。
- インストール:Unix 系なら install.sh を実行、Windows なら install.ps1 を管理者権限で実行。
- 動作:スクリプトが Claude CLI の認証情報を検出し、OpenCode の設定領域(ファイルまたは環境変数)へ書き込みを行う。
- 注意点:スクリプトの内容を事前に確認し、トークンが外部に送信されないことを確認してから実行すること。
まとめ
Claude CLI の認証を安全に OpenCode に同期する実用的なツール。導入が簡単で安全性を重視した設計。
リポジトリ情報:
- 名前: opencode-claude-auth-sync
- 説明: Sync Claude CLI credentials to OpenCode — no separate Anthropic login needed
- スター数: 26
- 言語: Shell
- URL: https://github.com/lehdqlsl/opencode-claude-auth-sync
- オーナー: lehdqlsl
- アバター: https://avatars.githubusercontent.com/u/7637916?v=4
READMEの抜粋:
opencode-claude-auth-sync
Sync your existing Claude CLI credentials to OpenCode — no separate Anthropic login needed.
Note: OpenCode has officially dropped native Anthropic authentication support. This tool is the recommended way to use Claude models with OpenCode if you have a Claude CLI subscription.
Why not an npm plugin? When auth breaks, npm packages pop up fast — but installing unknown packages that h…