Feat : Gitbook

2026-09-22 13:38:31 +00:00 · 2026-05-11 11:50:24 +07:00
parent 7ad538bcf2
commit fd92af77a0
124 changed files with 34154 additions and 4 deletions
@@ -0,0 +1,247 @@
+# はじめに
+
+9Routerを5分で起動し、AIリクエストをインテリジェントにルーティングし始めましょう。
+
+---
+
+## クイックスタート
+
+### 1. インストール
+
+```bash
+npm install -g 9router
+```
+
+**要件:** Node.js 20+ ([インストール詳細](getting-started/installation.md))
+
+### 2. 起動
+
+```bash
+9router
+```
+
+🎉 **ダッシュボードが自動的に開きます** (`http://localhost:20128`)
+
+- デフォルトパスワード: `123456` (ダッシュボードで変更)
+- APIキーは自動生成
+- プロバイダー接続の準備完了
+
+### 3. プロバイダーを接続
+
+プロバイダーを接続する方法は3つあります:
+
+#### オプションA: OAuth(サブスクリプションプロバイダー)
+
+**最適:** Claude Code、Codex、Gemini CLI、GitHub Copilot
+
+```
+Dashboard → Providers → Connect [Provider]
+→ OAuthログイン → トークン自動更新
+→ クォータトラッキング有効化
+```
+
+**例: Claude Code**
+1. 「Connect Claude Code」をクリック
+2. Claudeアカウントでログイン
+3. 9Routerを認可
+4. ✅ 完了! モデルを使用: `cc/claude-opus-4-5-20251101`
+
+#### オプションB: APIキー(低価格プロバイダー)
+
+**最適:** GLM、MiniMax、Kimi、OpenRouter
+
+```
+Dashboard → Providers → Add API Key
+→ プロバイダーを選択
+→ APIキーを貼り付け
+→ 保存
+```
+
+**例: GLM-4.7**
+1. [Zhipu AI](https://open.bigmodel.cn/)でサインアップ
+2. Coding PlanからAPIキーを取得
+3. Dashboard → Add API Key → Provider: `glm` → キーを貼り付け
+4. ✅ 完了! モデルを使用: `glm/glm-4.7`
+
+#### オプションC: 無料プロバイダー(コストなし)
+
+**最適:** iFlow、Qwen、Kiro
+
+```
+Dashboard → Providers → Connect [Free Provider]
+→ デバイスコードまたはOAuth
+→ 無制限利用
+```
+
+**例: iFlow**
+1. 「Connect iFlow」をクリック
+2. iFlowアカウントでログイン
+3. 認可
+4. ✅ 完了! 8モデルを使用: `if/kimi-k2-thinking`、`if/qwen3-coder-plus`など
+
+---
+
+## 4. CLIツールで使用
+
+コーディングツールを9Routerに向けます:
+
+### Cursor IDE
+
+```
+Settings → Models → Advanced:
+  OpenAI API Base URL: http://localhost:20128/v1
+  OpenAI API Key: [9routerダッシュボードから取得]
+  Model: cc/claude-opus-4-5-20251101
+```
+
+### Claude Desktop
+
+`~/.claude/config.json`を編集:
+
+```json
+{
+  "anthropic_api_base": "http://localhost:20128/v1",
+  "anthropic_api_key": "your-9router-api-key"
+}
+```
+
+### Cline / Continue / RooCode
+
+```
+Provider: OpenAI Compatible
+Base URL: http://localhost:20128/v1
+API Key: [ダッシュボードから取得]
+Model: cc/claude-opus-4-5-20251101
+```
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-9router-api-key"
+
+codex "your prompt"
+```
+
+---
+
+## 5. スマートコンボを作成(オプション)
+
+コンボはモデル間の自動フォールバックを可能にします:
+
+```
+Dashboard → Combos → Create New
+
+Name: premium-coding
+Models:
+  1. cc/claude-opus-4-5-20251101 (サブスクリプション優先)
+  2. glm/glm-4.7 (低価格バックアップ、100万あたり$0.6)
+  3. if/kimi-k2-thinking (無料フォールバック)
+
+CLIで使用: premium-coding
+```
+
+**動作:**
+1. 最初にClaude Opusを試行(サブスクリプション)
+2. クォータ消費時 → GLM-4.7(超低価格)
+3. 予算上限時 → iFlow(無料)
+4. ダウンタイムゼロ、自動切替!
+
+---
+
+## 利用可能なモデル
+
+### サブスクリプションモデル(最初に最大化)
+
+**Claude Code (`cc/`)** - Pro/Maxサブスクリプション:
+- `cc/claude-opus-4-5-20251101` - Claude 4.5 Opus
+- `cc/claude-sonnet-4-5-20250929` - Claude 4.5 Sonnet
+- `cc/claude-haiku-4-5-20251001` - Claude 4.5 Haiku
+
+**Codex (`cx/`)** - Plus/Proサブスクリプション:
+- `cx/gpt-5.2-codex` - GPT 5.2 Codex
+- `cx/gpt-5.1-codex-max` - GPT 5.1 Codex Max
+
+**Gemini CLI (`gc/`)** - 月18万無料:
+- `gc/gemini-3-flash-preview` - Gemini 3 Flash Preview
+- `gc/gemini-2.5-pro` - Gemini 2.5 Pro
+
+**GitHub Copilot (`gh/`)** - サブスクリプション:
+- `gh/gpt-5` - GPT-5
+- `gh/claude-4.5-sonnet` - Claude 4.5 Sonnet
+
+### 低価格モデル(バックアップ)
+
+**GLM (`glm/`)** - 100万あたり$0.6/$2.2:
+- `glm/glm-4.7` - GLM 4.7(毎日午前10時リセット)
+
+**MiniMax (`minimax/`)** - 100万あたり$0.20/$1.00:
+- `minimax/MiniMax-M2.1` - MiniMax M2.1(5時間リセット)
+
+**Kimi (`kimi/`)** - 月$9(1000万トークン):
+- `kimi/kimi-latest` - Kimi Latest
+
+### 無料モデル(緊急時)
+
+**iFlow (`if/`)** - 8モデル無料:
+- `if/kimi-k2-thinking` - Kimi K2 Thinking
+- `if/qwen3-coder-plus` - Qwen3 Coder Plus
+- `if/glm-4.7` - GLM 4.7
+- `if/deepseek-r1` - DeepSeek R1
+
+**Qwen (`qw/`)** - 3モデル無料:
+- `qw/qwen3-coder-plus` - Qwen3 Coder Plus
+- `qw/qwen3-coder-flash` - Qwen3 Coder Flash
+
+**Kiro (`kr/`)** - 2モデル無料:
+- `kr/claude-sonnet-4.5` - Claude Sonnet 4.5
+- `kr/claude-haiku-4.5` - Claude Haiku 4.5
+
+---
+
+## コスト最適化戦略
+
+### 月予算: $10〜20/月
+
+```
+1. クイックタスクにGemini CLI無料プラン(月18万)を使用
+2. Claude Codeサブスクリプションのクォータを完全利用(すでに支払い済み)
+3. クォータ切れ時はGLM(100万あたり$0.6)へフォールバック
+4. 緊急時: MiniMax M2.1(100万あたり$0.20)またはiFlow(無料)
+
+実例(月1億トークン):
+  Gemini CLI経由で6000万: $0(無料プラン)
+  Claude Code経由で3000万: $0(既存サブスクリプション)
+  GLM経由で800万: $4.80
+  MiniMax経由で200万: $0.40
+  合計: 月$5.20 + 既存サブスクリプション
+```
+
+### クォータリセット戦略
+
+```
+日課:
+1. 朝: Claude Codeの新しいクォータ(5時間リセット)
+2. 午後: Gemini CLIへ切替(1K/日)
+3. 夕方: GLM日次クォータ(翌朝10時リセット)
+4. 深夜: MiniMax(5時間ローリング)またはiFlow(無料)
+
+→ 最小の追加コストで24時間コーディング!
+```
+
+---
+
+## 次のステップ
+
+- [インストール詳細](getting-started/installation.md) - 要件、トラブルシューティング
+- [機能](features/) - クォータトラッキング、コンボ、デプロイを確認
+- [FAQ](faq.md) - よくある質問と回答
+- [トラブルシューティング](troubleshooting.md) - 一般的な問題の修正
+
+---
+
+## ヘルプが必要?
+
+- **ウェブサイト**: [9router.com](https://9router.com)
+- **GitHub**: [github.com/decolua/9router](https://github.com/decolua/9router)
+- **Issues**: [github.com/decolua/9router/issues](https://github.com/decolua/9router/issues)