# 企业团队版指南

QCode 企业团队版专为 **3 人以上开发团队** 设计，提供独立域名、子 API Key 管理、封号保障等企业级功能。本文详细介绍企业版的核心能力、部署方法和最佳实践。

---

## 企业版 vs 个人版

| 对比项 | 个人版 | 企业团队版 |
|--------|--------|-----------|
| **API 域名** | 共享 `api.qcode.cc`（中国用户可用 `api.qcode.cc`） | 专属 `e-xxx.qcode.cc` |
| **API Key 管理** | 1 个 Key | 无限子 Key，独立配额 |
| **后台管理** | 基础面板 | 完整管理控制台 |
| **API 隔离** | 共享实例 | 独立后端实例 |
| **封号保障** | 有 | 有（当日替换） |
| **实时监控** | 基础 | 全面（用量/速率/成本） |
| **发票** | 无 | 支持对公转账 + 正规发票 |
| **支持工具** | Claude Code + Codex | Claude Code + Codex + Cline + Aider + OpenCode + Gemini CLI |
| **适合人数** | 1 人 | 3-100+ 人 |
| **人均月费** | 按套餐 | **低至 ¥320/人/月** |

> **核心差异**：企业版每个客户拥有**完全独立的后端实例和域名**，API 流量与其他客户彻底隔离。

---

## 五大核心功能

### 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，每个 Key 设置独立的配额和限制：

```
团队 API Key 分配示例：
├── key-frontend-team    → 日配额 $50，3 人使用
├── key-backend-team     → 日配额 $80，4 人使用
├── key-devops           → 日配额 $20，2 人使用
└── key-intern           → 日配额 $10，1 人使用
```

- 技术上支持无限创建子 Key
- 每个 Key 独立配额和频率限制
- 随时启用/禁用，灵活控制
- **建议**：3 人共享一个 Max X20 账号最佳（避免高频使用导致封号）

### 3. 封号保障

Max X20 账号被 Anthropic 封禁时，QCode 提供**免费快速替换**：

- 白天工作时间约 **1-3 小时**完成新号替换
- 账号有效期内免费提供替换服务
- 多账号配置可降低中断风险

> **强烈建议**：配置 2+ 个账号，即使主号需要替换，团队也能立即切换到备用号。

### 4. 多工具支持

一个企业账户，所有 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（每个团队成员或小组一个）
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
- 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** | 多地域节点（香港/日本），自动故障切换 |
| **快速响应** | 7x14 在线（9:00-23:00），封号当日处理 |
| **合规支持** | 支持签署数据安全协议 |

---

## 成本对比

### 与自建方案对比

| 对比项 | 自建方案 | QCode 企业版 |
|--------|---------|-------------|
| 月费（9 人团队） | ¥8,000+（账号+服务器+运维） | ¥5,280（3 个 Max X20） |
| 人均月费 | ¥890+ | **¥533** |
| 管理系统 | 自行开发 | 开箱即用 |
| 封号保障 | 自行承担 | 免费替换 |
| 运维人力 | 需专人维护 | 零运维 |

### 与 Anthropic 官方对比

| 对比项 | Anthropic 官方 | QCode 企业版 |
|--------|--------------|-------------|
| 人均月费 | ~$60（约 ¥420） | **¥320-360** |
| 支持工具 | 仅 Claude Code | Claude Code + Codex + 更多 |
| 国内访问 | 需翻墙 | 亚太节点直连 |
| 发票 | 海外发票 | **国内正规发票** |
| 封号保障 | 无 | 免费替换 |

---

## 常见问题

### 最少购买几个账号？

1 个即可。支持从 1 个 Max X20 账号起步，随团队增长灵活扩展。

### 账号被封怎么办？

QCode 提供免费快速替换，发现封禁后当日内完成替换。建议配置多个账号降低中断风险。

### 支持哪些工具？

Claude Code、Codex CLI、Cline、Aider、OpenCode、Gemini CLI。一个配额在所有工具间共享。

### 支持对公转账吗？

支持。提供正规增值税发票（5% 工本费），可签署正式服务协议。

### 可以先体验再买吗？

当然可以。先在 [定价页面](https://qcode.cc/pricing) 购买个人体验版（¥60/月），体验满意后再升级企业版。

### 与个人版的 API 兼容吗？

完全兼容。企业版只是 API 域名不同（`e-xxx.qcode.cc` vs `api.qcode.cc`），其他配置方式完全一致，无需修改代码。

---

## 立即开始

准备为团队升级开发体验？

- **在线咨询**：[qcode.cc](https://qcode.cc) 右下角在线客服
- **邮件**：hi@qcode.cc
- **企业版详情**：[qcode.cc/enterprise](https://qcode.cc/enterprise)

> 咨询时请告知：团队规模、预计使用人数、希望购买的账号数量。