raine/claude-code-proxy

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

これは何か

claude-code-proxy は、Claude Code エディター(Anthropic の Claude 上に構築されたコーディングアシスタント UI)と、OpenAI Codex、Kimi、Grok、OpenCode Go、Cursor Agent などのさまざまな大規模言語モデルプロバイダーとの間にある小さなローカルサーバーです。Claude Code が期待する Anthropic スタイルの API 呼び出しを、それらのプロバイダーのネイティブ API に変換し、認証、モデルルーティング、ストリーミング応答、基本的な診断を処理します。

なぜ重要か

Claude Code はすでに豊富なコーディングアシスタント機能(コード補完、リファクタリング、ドキュメント、サブエージェント、エディター統合)を提供しています。ただし、Claude Code は Anthropic の有料 API にハードワイヤードされています。プロキシを使用すると、同じ UI を維持しながら、任意のサポートされているサブスクリプションベースのバックエンドを使用でき、コストを削減したり、異なる強みを持つモデル(例:Kimi-for-coding、Grok、Cursor)にアクセスしたりできます。また、リクエストレート、トークン使用量、エラーをリアルタイムで確認できるローカルモニター UI も提供します。

始め方

  1. インストール – macOS/Linux では、brew install raine/claude-code-proxy/claude-code-proxy またはリポジトリからワンラインインストーラースクリプトを実行できます。Windows バイナリは GitHub releases ページにあります。
  2. 認証 – ChatGPT Plus または Pro アカウントでログインします(プロキシは ChatGPT セッショントークンを使用し、OpenAI API キーは使用しません):
    claude-code-proxy codex auth login
    
  3. プロキシを実行 – ターミナルで起動します:
    claude-code-proxy serve
    
    オプションで --no-monitor を追加してバックグラウンドサービスとして実行し、後で claude-code-proxy monitor で TUI モニターをアタッチできます。
  4. Claude Code を起動 – いくつかの環境変数を設定してエディターをローカルプロキシに向けます。例:
    ANTHROPIC_BASE_URL=http://127.0.0.1:18765 \
    ANTHROPIC_AUTH_TOKEN=unused \
    ANTHROPIC_MODEL=gpt-6-sol \
    claude
    
    プロキシは認証したプロバイダーにリクエストを転送します。
  5. オプションの画像生成 – CCP_CODEX_IMAGES_API=1 で Codex 画像エンドポイントを有効にし、ローカルの /v1/images/generations エンドポイントを呼び出します。プロキシはリクエストをサインインした ChatGPT アカウントの画像クォータに転送します。

主な機能

機能 説明
マルチプロバイダーサポート Codex、Kimi、Grok、OpenCode Go、Cursor Agent で動作します。利用可能なモデルは claude-code-proxy models で一覧表示できます。
認証処理 選択したプロバイダー(例:ChatGPT Plus)にログインし、セッショントークンをローカルに保存します。
プロトコル変換 Claude Code からの Anthropic スタイルの HTTP リクエストを受け入れ、プロバイダーのネイティブ API 形式に変換します。
ストリーミング応答 Claude Code が期待するトークンごとのストリーミングを保持し、UI が即座に感じられるようにします。
ローカルモニター TUI claude-code-proxy monitor は、アクティブなセッション、最近のリクエスト、エラー、トークン使用量、スループットを表示します。
診断とルーティング 環境変数に基づいてリクエストを適切なモデルにルーティングします。プロジェクトごとに設定可能です。
画像生成(オプトイン) ChatGPT 画像クォータを使用して base64 エンコードされた画像を返す /v1/images/generations エンドポイントを公開します。
安全警告 デフォルトでは 127.0.0.1 にのみバインドします。外部に公開する場合は、ファイアウォールまたはリバースプロキシ保護を追加する必要があります。

誰が使うか

  • Claude Code を愛用する開発者で、より安価または専門的なモデルに切り替えたい人。
  • 複数のコーディングエージェントを実行するパワーユーザー(例:著者の aven タスクキュー経由)で、異なるバックエンドにルーティングできる単一のローカルエンドポイントが必要な人。
  • モデルパフォーマンスを実験する研究者が、Claude Code クライアントを書き直すことなく、Codex、Kimi、Grok などで実験したい人。

制限事項

  • プロキシはローカル(ループバック)接続のみを受け入れます。公開するには追加のセキュリティ手順が必要です。
  • 各プロバイダーのサブスクリプションアカウントに依存します。プロキシは無料層アクセスを提供しません。
  • 非公式の使用はプロバイダーの利用規約に違反する可能性があるため、ユーザーはリスクを負います。

詳細情報

リポジトリは、claude-code-proxy.raine.dev でホストされている広範なドキュメント(入門ガイド、プロバイダー比較、構成オプション、HTTP API リファレンス、モニター TUI ガイド)へのリンクを提供しています。


ライセンス:MIT

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト