
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://nodejs.org/)
[](https://aiproxy.justlikemaki.vip/ja/docs/installation/docker-deployment.html)
[**中文**](./README-ZH.md) | [**English**](./README.md) | [**日本語**](./README-JA.md) | [**📚 完全ドキュメント**](https://aiproxy.justlikemaki.vip/ja/)
`AIClient2API` はクライアント制限を突破するAPIプロキシサービスで、元々クライアント内でのみ使用可能な無料大規模モデル(Gemini CLI、Qwen Code Plus、Kiro Claudeなど)を、あらゆるアプリケーションから呼び出せる標準OpenAI互換インターフェースに変換します。Node.jsをベースに構築され、OpenAI、Claude、Geminiの3大プロトコル間のインテリジェント変換をサポートし、Cherry-Studio、NextChat、Clineなどのツールで、Claude Sonnet 4.5、Gemini 2.5 Flash、Qwen3 Coder Plusなどの高度なモデルを大規模に無料で使用できるようにします。プロジェクトはストラテジーパターンとアダプターパターンに基づくモジュラーアーキテクチャを採用し、アカウントプール管理、インテリジェントポーリング、自動フェイルオーバー、ヘルスチェック機構を内蔵し、99.9%のサービス可用性を保証します。
> [!NOTE]
> **🎉 重要なマイルストーン**
>
> - Ruan Yifeng先生による[週刊359号](https://www.ruanyifeng.com/blog/2025/08/weekly-issue-359.html)での推薦に感謝します
>
> **📅 バージョン更新ログ**
>
> - **2025.11.30** - Antigravityプロトコルサポートの追加、Google内部インターフェース経由でGemini 3 Pro、Claude Sonnet 4.5などのモデルへのアクセスをサポート
> - **2025.11.16** - Ollamaプロトコルサポートの追加、統一インターフェースでサポートされるすべてのモデルにアクセス
> - **2025.11.11** - Web UI管理コントロールコンソールの追加、リアルタイム設定管理与健康状態モニタリングをサポート
> - **2025.11.06** - Gemini 3 プレビュー版のサポートを追加、モデル互換性とパフォーマンス最適化を向上
> - **2025.10.18** - Kiroオープン登録、新規アカウントに500クレジット付与、Claude Sonnet 4.5を完全サポート
> - **2025.09.01** - Qwen Code CLIを統合、`qwen3-coder-plus`モデルサポートを追加
> - **2025.08.29** - アカウントプール管理機能をリリース、マルチアカウントポーリング、自動フェイルオーバー、自動ダウングレード戦略をサポート
> - 設定方法:config.jsonに`PROVIDER_POOLS_FILE_PATH`パラメータを追加
> - 参考設定:[provider_pools.json](./provider_pools.json.example)
---
## 💡 コアアドバンテージ
### 🎯 統一アクセス、ワンストップ管理
* **マルチモデル統一インターフェース**:標準OpenAI互換プロトコルを通じて、一度の設定でGemini、Claude、GPT、Qwen Code、Kimi K2、GLM-4.6などの主流大規模モデルにアクセス
* **柔軟な切り替えメカニズム**:起動パラメータ、Pathルーティング、環境変数の3つの方法で動的にモデルを切り替え、異なるシナリオのニーズに対応
* **ゼロコスト移行**:OpenAI API仕様と完全互換、Cherry-Studio、NextChat、Clineなどのツールを変更なしで使用可能
* **マルチプロトコルインテリジェント変換**:OpenAI、Claude、Geminiの3大プロトコル間のインテリジェント変換をサポートし、クロスプロトコルモデル呼び出しを実現
* OpenAIプロトコルでClaudeモデルを呼び出す:`claude-custom`または`claude-kiro-oauth`プロバイダーを使用
* OpenAIプロトコルでGeminiモデルを呼び出す:`gemini-cli-oauth`プロバイダーを使用
* ClaudeプロトコルでGeminiモデルを呼び出す:`gemini-cli-oauth`プロバイダーを使用
* ClaudeプロトコルでOpenAIモデルを呼び出す:`openai-custom`または`openai-qwen-oauth`プロバイダーを使用
### 🚀 制限を突破、効率を向上
* **公式制限の回避**:OAuth認証メカニズムを利用して、Geminiなどの無料APIのレート制限と割り当て制限を効果的に突破
* **無料高度モデル**:Kiro APIモードでClaude Sonnet 4.5を無料使用、Qwen OAuthモードでQwen3 Coder Plusを使用し、使用コストを削減
* **インテリジェントアカウントプールスケジューリング**:マルチアカウントポーリング、自動フェイルオーバー、設定ダウングレードをサポートし、99.9%のサービス可用性を保証
### 🛡️ 安全で制御可能、データ透明
* **フルチェーンログ記録**:すべてのリクエストとレスポンスデータをキャプチャし、監査とデバッグをサポート
* **プライベートデータセット構築**:ログデータに基づいて専用トレーニングデータセットを迅速に構築
* **システムプロンプト管理**:オーバーライドと追加の2つのモードをサポートし、統一された基本指示と個別拡張の完璧な組み合わせを実現
### 🔧 開発者フレンドリー、拡張が容易
* **モジュラーアーキテクチャ**:ストラテジーパターンとアダプターパターンに基づき、新しいモデルプロバイダーの追加はわずか3ステップ
* **完全なテストカバレッジ**:統合テストと単体テストのカバレッジ90%+、コード品質を保証
* **コンテナ化デプロイ**:Dockerサポートを提供、ワンクリックデプロイ、クロスプラットフォーム実行
* **MCPプロトコルサポート**:Model Context Protocolと完全互換、機能を簡単に拡張
---
## 📑 クイックナビゲーション
- [🐳 Docker デプロイ](https://aiproxy.justlikemaki.vip/ja/docs/installation/docker-deployment.html)
- [🎨 モデルプロトコルとプロバイダー関係図](#-モデルプロトコルとプロバイダー関係図)
- [🔧 使用方法](#-使用方法)
- [🚀 プロジェクト起動パラメータ](#-プロジェクト起動パラメータ)
- [📄 オープンソースライセンス](#-オープンソースライセンス)
- [🙏 謝辞](#-謝辞)
- [⚠️ 免責事項](#-免責事項)
---
## 🎨 モデルプロトコルとプロバイダー関係図
本プロジェクトは異なるプロトコルを通じて複数のモデルプロバイダーをサポートします。以下はそれらの関係の概要です:
* **OpenAIプロトコル (P_OPENAI)**:`openai-custom`、`gemini-cli-oauth`、`claude-custom`、`claude-kiro-oauth`、`openai-qwen-oauth`、`openaiResponses-custom`モデルプロバイダーによって実装。
* **Claudeプロトコル (P_CLAUDE)**:`claude-custom`、`claude-kiro-oauth`、`gemini-cli-oauth`、`openai-custom`、`openai-qwen-oauth`、`openaiResponses-custom`モデルプロバイダーによって実装。
* **Geminiプロトコル (P_GEMINI)**:`gemini-cli-oauth`モデルプロバイダーによって実装。
詳細な関係図:
```mermaid
graph TD
subgraph Core_Protocols["コアプロトコル"]
P_OPENAI[OpenAI Protocol]
P_GEMINI[Gemini Protocol]
P_CLAUDE[Claude Protocol]
end
subgraph Supported_Model_Providers["サポートモデルプロバイダー"]
MP_OPENAI[openai-custom]
MP_GEMINI[gemini-cli-oauth]
MP_CLAUDE_C[claude-custom]
MP_CLAUDE_K[claude-kiro-oauth]
MP_QWEN[openai-qwen-oauth]
MP_OPENAI_RESP[openaiResponses-custom]
end
P_OPENAI ---|サポート| MP_OPENAI
P_OPENAI ---|サポート| MP_QWEN
P_OPENAI ---|サポート| MP_GEMINI
P_OPENAI ---|サポート| MP_CLAUDE_C
P_OPENAI ---|サポート| MP_CLAUDE_K
P_OPENAI ---|サポート| MP_OPENAI_RESP
P_GEMINI ---|サポート| MP_GEMINI
P_CLAUDE ---|サポート| MP_CLAUDE_C
P_CLAUDE ---|サポート| MP_CLAUDE_K
P_CLAUDE ---|サポート| MP_GEMINI
P_CLAUDE ---|サポート| MP_OPENAI
P_CLAUDE ---|サポート| MP_QWEN
P_CLAUDE ---|サポート| MP_OPENAI_RESP
style P_OPENAI fill:#f9f,stroke:#333,stroke-width:2px
style P_GEMINI fill:#ccf,stroke:#333,stroke-width:2px
style P_CLAUDE fill:#cfc,stroke:#333,stroke-width:2px
```
---
## 🔧 使用方法
### 🚀 install-and-run スクリプトでクイックスタート
AIClient-2-APIを使い始める最も簡単な方法は、自動的にインストールと起動を実行するスクリプトを使用することです。Linux/macOS版とWindows版の2つのバージョンを提供:
#### Linux/macOS ユーザー向け
```bash
# スクリプトに実行権限を付与して実行
chmod +x install-and-run.sh
./install-and-run.sh
```
#### Windows ユーザー向け
```cmd
# バッチファイルを実行
install-and-run.bat
```
#### スクリプトの機能
`install-and-run` スクリプトは自動的に以下の操作を実行します:
1. **Node.js インストール確認**:Node.js がインストールされているかを確認し、不足の場合はダウンロードリンクを提供
2. **依存関係管理**:`node_modules` が存在しない場合、npm 依存関係を自動インストール
3. **ファイル検証**:すべての必要なプロジェクトファイルが存在することを確認
4. **サーバー起動**:`http://localhost:3000` で API サーバーを起動
5. **Web UI アクセス**:管理コンソールへの直接アクセスを提供
#### スクリプト実行例
```
========================================
AI Client 2 API 快速インストール起動スクリプト
========================================
[確認] Node.js がインストールされているかを確認中...
✅ Node.js がインストールされています、バージョン: v20.10.0
✅ package.json ファイルが見つかりました
✅ node_modules ディレクトリが既に存在しています
✅ プロジェクトファイルの確認が完了しました
========================================
AI Client 2 API サーバーを起動中...
========================================
🌐 サーバーは http://localhost:3000 で起動します
📖 管理インターフェースを表示するには http://localhost:3000 にアクセス
⏹️ サーバーを停止するには Ctrl+C を押してください
```
> **💡 ヒント**:スクリプトは自動的に依存関係をインストールし、サーバーを起動します。問題が発生した場合、スクリプトは明確なエラーメッセージと解決案を提供します。
---
### 📋 コア機能
#### Web UI管理コントロールコンソール

以下の機能モジュールを備えたWeb管理インターフェース:
**📊 ダッシュボード**:システム概要、インタラクティブなルーティング例、クライアント設定ガイド
**⚙️ 設定管理**:全プロバイダー(Gemini、OpenAI、Claude、Kiro、Qwen)のリアルタイムパラメータ修正、高度設定、ファイルアップロード対応
**🔗 プロバイダープール**:アクティブ接続監視、プロバイダー健全性統計、有効化/無効化管理
**📁 設定ファイル**:OAuth資格情報の集中管理、検索フィルタリング、ファイル操作機能
**📜 リアルタイムログ**:システムログとリクエストログのライブ表示、管理コントロール付き
**🔐 ログイン**:認証が必要(デフォルト:`admin123`、`pwd`ファイルで変更可能)
アクセス:`http://localhost:3000` → ログイン → サイドバーナビゲーション → 即座有効
#### MCPプロトコルサポート
本プロジェクトは**Model Context Protocol (MCP)**と完全互換で、MCPをサポートするクライアントとシームレスに統合し、強力な機能拡張を実現します。
#### マルチモーダル入力機能
画像、ドキュメントなど様々なタイプの入力をサポートし、よりリッチなインタラクティブ体験とより強力なアプリケーションシナリオを提供します。
#### 最新モデルサポート
以下の最新大規模モデルをシームレスにサポート、[`config.json`](./config.json)で対応するOpenAIまたはClaude互換インターフェースを設定するだけで使用可能:
* **Kimi K2** - 月之暗面の最新フラッグシップモデル
* **GLM-4.5** - 智譜AIの最新バージョン
* **Qwen Code** - アリババ通義千問のコード専用モデル
* **Gemini 3** - Googleの最新プレビューモデル
* **Claude Sonnet 4.5** - Anthropicの最新フラッグシップモデル
---
### 🔐 認証設定ガイド
#### Gemini CLI OAuth設定
1. **OAuth認証情報の取得**:[Google Cloud Console](https://console.cloud.google.com/)にアクセスしてプロジェクトを作成し、Gemini APIを有効化
2. **初回認証**:Geminiサービス使用後、コマンドラインにGoogle認証ページが表示されるので、ページをブラウザにコピーして認証し、コマンドラインに戻る
3. **認証情報の保存**:認証成功後、`oauth_creds.json`ファイルが自動生成され、`~/.gemini`ディレクトリに保存される
4. **プロジェクト設定**:有効なGoogle CloudプロジェクトIDを提供する必要があり、起動パラメータ`--project-id`で指定可能
#### Qwen Code OAuth設定
1. **初回認証**:サービス起動後、システムが自動的にブラウザで認証ページを開く
2. **認証情報の保存**:認証成功後、`oauth_creds.json`ファイルが自動生成され、`~/.qwen`ディレクトリに保存される
3. **推奨パラメータ**:最良の結果を得るために公式デフォルトパラメータを使用
```json
{
"temperature": 0,
"top_p": 1
}
```
#### Kiro API設定
1. **環境準備**:[Kiroクライアントをダウンロードしてインストール](https://aibook.ren/archives/kiro-install)
2. **認証完了**:クライアントでアカウントにログインし、`kiro-auth-token.json`認証情報ファイルを生成
3. **ベストプラクティス**:**Claude Code**との併用を推奨、最適な体験を得られる
4. **重要なお知らせ**:Kiroサービス使用ポリシーが更新されました、最新の使用制限と条件については公式ウェブサイトをご確認ください
#### アカウントプール管理設定
1. **プール設定ファイルの作成**:[provider_pools.json.example](./provider_pools.json.example) を参考に設定ファイルを作成します
2. **プールパラメータの設定**:config.json で `PROVIDER_POOLS_FILE_PATH` を設定し、プール設定ファイルを指定します
3. **起動パラメータ設定**:`--provider-pools-file