# エンタープライズチーム版ガイド

QCode エンタープライズチーム版は **3 名以上の開発チーム** 向けに設計され、専用ドメイン・サブ API Key 管理・アカウント保護といった企業向け機能を提供します。本記事では中核機能、導入方法、ベストプラクティスを詳しく説明します。

---

## 企業版 vs 個人版

| 項目 | 個人版 | エンタープライズチーム版 |
|--------|--------|-----------|
| **API ドメイン** | 共有 `api.qcode.cc`（中国のユーザーも `api.qcode.cc` を利用可） | 専用 `e-xxx.qcode.cc` |
| **API Key 管理** | 1 個 | サブ Key 無制限、個別クォータ |
| **管理画面** | 基本パネル | 完全な管理コンソール |
| **API の分離** | 共有インスタンス | 独立したバックエンドインスタンス |
| **アカウント保護** | あり | あり（当日中に差し替え） |
| **リアルタイム監視** | 基本 | 包括的（使用量 / レート / コスト） |
| **請求書** | なし | 法人振込 + 正規インボイスに対応 |
| **対応ツール** | Claude Code + Codex | Claude Code + Codex + Cline + Aider + OpenCode + Gemini CLI |
| **想定人数** | 1 名 | 3〜100 名以上 |
| **1 人あたり月額** | プランによる | **¥320／人／月から** |

> **本質的な違い**：企業版では顧客ごとに **完全に独立したバックエンドインスタンスとドメイン** を持ち、API トラフィックが他の顧客と完全に分離されます。

---

## 5 つのコア機能

### 1. 専用ドメイン + 管理システム

企業のお客様ごとに専用ドメイン `e-xxx.qcode.cc` が割り当てられます：

```
チーム専用の API アドレス：
https://e-xxx.qcode.cc/api

管理画面：
https://e-xxx.qcode.cc/admin
```

- 独立した管理画面と独立したログイン体系
- API アドレスは他の顧客と完全に分離
- チームの API 利用状況をリアルタイムで監視

### 2. 柔軟なサブ API Key 管理

管理者は複数のサブ API Key を作成し、それぞれに個別のクォータと制限を設定できます：

```
チームの API Key 割り当て例：
├── key-frontend-team    → 日次クォータ $50、3 名で使用
├── key-backend-team     → 日次クォータ $80、4 名で使用
├── key-devops           → 日次クォータ $20、2 名で使用
└── key-intern           → 日次クォータ $10、1 名で使用
```

- 技術的にはサブ Key を無制限に作成できます
- Key ごとに独立したクォータとレート制限
- いつでも有効化 / 無効化でき、柔軟に制御できます
- **推奨**：Max X20 アカウント 1 つを 3 名で共有するのが最適です（高頻度利用による BAN を避けるため）

### 3. アカウント保護

Max X20 アカウントが Anthropic により凍結された場合、QCode が **無料で迅速に差し替え** ます：

- 日中の営業時間帯であれば約 **1〜3 時間** で新しいアカウントに差し替え
- 契約期間中は差し替えサービスを無料で提供
- 複数アカウント構成により中断リスクを下げられます

> **強く推奨**：2 つ以上のアカウントを用意しておけば、主アカウントの差し替え中もチームは即座に予備へ切り替えられます。

### 4. マルチツール対応

1 つの企業アカウントで、すべての AI コーディングツールがクォータを共有します：

| ツール | 設定方法 |
|------|---------|
| **Claude Code** | `ANTHROPIC_BASE_URL=https://e-xxx.qcode.cc/api` |
| **Codex CLI** | `base_url = "https://e-xxx.qcode.cc/openai"` |
| **Cline** | VS Code の設定で API base URL を指定 |
| **Aider** | `--openai-api-base https://e-xxx.qcode.cc/openai` |
| **OpenCode** | 環境変数で設定 |
| **Gemini CLI** | API 互換レイヤー経由で接続 |

### 5. チームに合わせて柔軟に拡張

アカウント 1 つから始めて、いつでも追加できます：

| 段階 | アカウント数 | 推奨人数 | 月額単価 |
|------|--------|---------|---------|
| スタート | 1 個 | 3 名 | ¥1,800 |
| 成長 | 3 個 | 9 名 | ¥1,760 |
| 拡大 | 7 個 | 21 名 | ¥1,720 |
| 大規模 | 11 個以上 | 33 名以上 | ¥1,680 |

---

## チーム展開ガイド

### ステップ 1：企業アカウントを開設する

QCode のサポートに連絡して企業アカウントを開設します：
- **オンライン相談**：[qcode.cc](https://qcode.cc) 右下のオンラインサポート
- **メール**：hi@qcode.cc

お知らせいただく内容：チーム規模、想定アカウント数、特別な要件。

### ステップ 2：管理者による設定

開設後、管理者は専用の管理画面 `e-xxx.qcode.cc/admin` にログインします：

1. サブ API Key を作成する（チームメンバーごと、またはグループごとに 1 つ）
2. Key ごとに日次クォータを設定する
3. チームメンバーに配布する

### ステップ 3：メンバー側の設定

各メンバーはローカルで環境変数を設定します：

**Claude Code：**
```bash
export ANTHROPIC_BASE_URL=https://e-xxx.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_管理者から配布されたサブKey
```

**Codex CLI：**
```toml
# ~/.codex/config.toml
[providers.openai]
base_url = "https://e-xxx.qcode.cc/openai"
```

```bash
export CRS_OAI_KEY=cr_管理者から配布されたサブKey
```

### ステップ 4：チーム共通の CLAUDE.md

プロジェクトのルートに共通の CLAUDE.md を作り、Git にコミットしてチーム全体で共有することをおすすめします：

```markdown
# チームプロジェクトの CLAUDE.md

## チーム規約
- コードスタイル：.eslintrc と .prettierrc に従う
- Git ブランチ：feature/xxx。main への直接 push は禁止
- PR は 2 名のレビュー通過が必須
- テストカバレッジ 80% 以上

## よく使うコマンド
- dev: pnpm dev
- test: pnpm test
- build: pnpm build

## 注意事項
- API Key はリポジトリにコミットしない
- 機密ファイルは .gitignore を参照
```

> CLAUDE.md の完全な設定は [CLAUDE.md 設定ガイド](/docs/usage/claude-md) を参照してください。

### ステップ 5：セキュリティポリシーの設定

Hooks を使ってチーム全体にセキュリティポリシーを強制できます：

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "echo $TOOL_INPUT | grep -qE 'rm -rf|sudo rm|git push --force' && exit 2 || exit 0"
        }]
      },
      {
        "matcher": "Read|Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "echo $TOOL_INPUT | grep -qE '\\.env|credentials|secret' && exit 2 || exit 0"
        }]
      }
    ]
  }
}
```

> 詳しくは [Hooks システム](/docs/advanced/hooks) と [セキュリティのベストプラクティス](/docs/advanced/security) を参照してください。

---

## セキュリティ

| 項目 | 内容 |
|--------|------|
| **API の完全分離** | 顧客ごとに専用ドメインとバックエンドインスタンス |
| **データ非保持** | コード・会話・業務データを保存しません |
| **リクエストの透過転送** | すべてのリクエストは上流 API にそのまま転送されます |
| **99.9% SLA** | 複数リージョンのノード（香港 / 日本）、自動フェイルオーバー |
| **迅速な対応** | 週 7 日・14 時間（9:00〜23:00）、BAN は当日対応 |
| **コンプライアンス** | データセキュリティ契約の締結に対応 |

---

## コスト比較

### 自前構築との比較

| 項目 | 自前構築 | QCode 企業版 |
|--------|---------|-------------|
| 月額（9 名チーム） | ¥8,000 以上（アカウント + サーバー + 運用） | ¥5,280（Max X20 × 3） |
| 1 人あたり月額 | ¥890 以上 | **¥533** |
| 管理システム | 自前で開発 | すぐ使える |
| アカウント保護 | 自己責任 | 無料で差し替え |
| 運用工数 | 専任が必要 | 運用ゼロ |

### Anthropic 公式との比較

| 項目 | Anthropic 公式 | QCode 企業版 |
|--------|--------------|-------------|
| 1 人あたり月額 | 約 $60（約 ¥420） | **¥320〜360** |
| 対応ツール | Claude Code のみ | Claude Code + Codex + その他 |
| 中国からのアクセス | VPN が必要 | アジア太平洋ノードに直接接続 |
| 請求書 | 海外の請求書 | **中国国内の正規インボイス** |
| アカウント保護 | なし | 無料で差し替え |

---

## よくある質問

### 最低何アカウントから購入できますか？

1 つからで大丈夫です。Max X20 アカウント 1 つから始めて、チームの成長に合わせて柔軟に拡張できます。

### アカウントが凍結されたらどうなりますか？

QCode が無料で迅速に差し替えます。凍結を検知した当日中に対応します。中断リスクを下げるため、複数アカウントの構成をおすすめします。

### どのツールに対応していますか？

Claude Code、Codex CLI、Cline、Aider、OpenCode、Gemini CLI です。1 つのクォータをすべてのツールで共有します。

### 法人振込には対応していますか？

対応しています。正規の増値税インボイスを発行でき（事務手数料 5%）、正式なサービス契約も締結できます。

### 購入前に試せますか？

もちろんです。まず [料金ページ](https://qcode.cc/pricing) で個人向けのお試しプラン（月 ¥60）を購入し、納得いただいてから企業版にアップグレードできます。

### 個人版と API の互換性はありますか？

完全に互換です。企業版は API ドメインが違うだけで（`e-xxx.qcode.cc` と `api.qcode.cc`）、その他の設定方法はまったく同じです。コードを変更する必要はありません。

---

## はじめる

チームの開発体験をアップグレードする準備はできましたか？

- **オンライン相談**：[qcode.cc](https://qcode.cc) 右下のオンラインサポート
- **メール**：hi@qcode.cc
- **企業版の詳細**：[qcode.cc/enterprise](https://qcode.cc/enterprise)

> お問い合わせの際は、チーム規模・想定利用人数・希望アカウント数をお知らせください。