# 研发团队工具管理

来源: https://platform.lyrouter.com/ai_gateway/docs/dev-team
更新日期: 2026-10-22

为研发团队接入 Claude Code、Codex 等编程工具时，推荐的做法是：按项目或环境划分工作空间，每位成员或每个应用使用自己创建的 API Key，工具里统一填写虚拟模型名。这样预算、权限、日志和用量都能按人、按应用分开统计，更换模型时也不必逐台修改工具配置。

## 按项目或环境划分工作空间

工作空间是隔离调用配置的单位，一把 API Key 只属于一个工作空间：

| 范围 | 内容 |
| --- | --- |
| 每个工作空间独立 | API Key、模型广场中开通的模型、BYOK、智能路由、虚拟模型、安全围栏策略、全文日志设置、日志与用量 |
| 整个组织共用 | Credits 余额、订阅，以及成员和部门 |

团队和企业的当前账号管理员在 **工作空间** 页面点击 **新建工作空间** 创建，例如为「编程助手-测试」和「编程助手-生产」各建一个，数量上限由订阅档位决定。个人版只有一个默认工作空间。

（截图：「工作空间」页列出可进入的空间，卡片显示你的角色和共享标签；账号管理员可新建工作空间。）

用「访问范围」决定谁自动获得权限：「组织共享」给组织全部有效成员，「指定部门」给所选部门的成员，「仅自己/指定成员」只给账号管理员和单独授权的成员。前两种范围的成员获得「共享成员角色」，新设置的共享一律为「编辑者」；较早设成「查看者」的共享保持不变，直到修改访问范围。成员同时有单独授权和共享授权时，单独授权优先生效。工作空间内的角色决定能做什么：

| 角色 | 与工具接入相关的能力 |
| --- | --- |
| 查看者 | 查看空间内已授权的资源，不能创建 API Key |
| 编辑者 | 创建、编辑自己的 API Key |
| 管理员 | 另外可以开通或停用模型、查看全部成员的日志并导出 |

生产空间建议用「仅自己/指定成员」，只给负责人单独授予「管理员」；成员与授权的管理见[组织、成员与角色](https://platform.lyrouter.com/ai_gateway/docs/organization)。

## 每人或每个应用一把 Key

工作空间角色为「编辑者」及以上的成员，在 **API 密钥** 页面点击 **创建 API 密钥** 创建，完整密钥只显示一次。控制台创建的 Key 都是「仅自己使用」：只有创建人和当前账号管理员能看到、编辑、禁用或删除它，用量也记在创建人名下。因此请让每位成员用自己的账号创建 Key，不要由账号管理员统一创建后分发，否则所有用量都会算在账号管理员名下。早期创建的共享 Key（「指定成员」或「当前空间全部成员」）对相应成员仍然可见，新建时已不再提供这两个选项。

创建时按三步设置：

| 步骤 | 设置 | 效果 |
| --- | --- | --- |
| 基本信息 | 「名称」和「到期时间」：「永不过期」或「指定到期时间」，精确到秒，只选日期时默认当天 23:59:59 | 过期后返回 403 `api key expired` |
| 预算限额 | 「费用预算（元）」和「Token 预算（百万 Token）」，各有「每月」「总计」两项，留空表示不限 | 用完后返回 429 `rate limit exceeded on apikey ...` |
| 访问控制 | 「启用 IP 白名单」，填写 IPv4 地址或 CIDR 网段 | 其他来源返回 403 `your IP address is not allowed` |

为 CI 等固定出口的应用开启 IP 白名单，并为临时成员设置到期时间。这些报错的处理见[401 / 403：鉴权与权限](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)和[429：限流与配额](https://platform.lyrouter.com/ai_gateway/docs/rate-errors)。轮换 Key 时先创建新 Key、更新工具配置并确认调用正常，再禁用和删除旧 Key。

## 用「使用密钥」生成工具配置

生成密钥后，在「请妥善保存密钥」窗口复制密钥，勾选「我已复制并安全保存此密钥」，再点击 **我已保存，查看配置示例**，「使用 API 密钥」窗口会给出已填好这把密钥的配置。之后也可以在列表操作列点击 **使用密钥** 打开，此时示例中的密钥显示为 `YOUR_API_KEY`，需要换成你保存的完整密钥。

| 页签 | 内容 | 接入地址 |
| --- | --- | --- |
| cURL | 对话请求和列出可用模型 | `https://api.lyrouter.com/v1` |
| API | Python、Node.js 的 OpenAI SDK，以及 Anthropic SDK | OpenAI SDK 用 `/v1`；Anthropic SDK 用根地址 `https://api.lyrouter.com` |
| TRAE、WorkBuddy | 在工具中填写的服务商、地址、密钥和模型 | `https://api.lyrouter.com/v1` |
| CC Switch | 「供应商名称」、地址、Auth Token 和默认模型 | 根地址 |
| Claude Code | macOS / Linux、Windows CMD、PowerShell 的环境变量，以及 `~/.claude/settings.json` | 根地址 |
| OpenCode | `opencode.json` 配置和环境变量两种写法 | `opencode.json` 用 `/v1`；环境变量写法用根地址 |

窗口顶部的「示例模型」只列出这把 Key 可以调用的模型。Anthropic 协议的工具会自己拼接 `/v1/messages`，地址填根地址，多写 `/v1` 会返回 404。Codex、ChatGPT 等其他工具见[工具兼容性与接入总览](https://platform.lyrouter.com/ai_gateway/docs/tools)。

## 在工具中统一使用虚拟模型名

请当前账号管理员在 **虚拟模型** 页面为团队创建虚拟模型，例如 `team-coding`，大家在工具中把模型填为 `@vmodel/team-coding`。之后更换模型只需修改虚拟模型的「默认模型」，保存后对所有成员的新请求生效。

- 编程工具依赖工具调用和流式输出，「备用模型」也要支持这些能力。
- 虚拟模型的推理参数按 Chat Completions 的字段名合并。给 Codex 这类使用 Responses 的工具使用时，建议只设置 `temperature`、`top_p` 这类通用参数。
- 虚拟模型属于一个工作空间，该工作空间的任何有效 API Key 都可以调用，配置方法见[虚拟模型](https://platform.lyrouter.com/ai_gateway/docs/presets)。

## 设置团队额度

API Key 的预算只约束单把 Key。需要按成员、部门或整个工作空间控制用量时，账号管理员在 **安全围栏** 中新建「配额管理」策略；限制成员或 Key 能调用的模型，使用「模型访问控制」策略。安全围栏从团队版起可用，见[预算、配额与限流](https://platform.lyrouter.com/ai_gateway/docs/quota)和[模型授权](https://platform.lyrouter.com/ai_gateway/docs/authorization)。成员可以在控制台概览页的「我的配额」查看剩余额度。

（截图：在安全围栏的配额策略中为部门设置每月信用点额度、清零日、预警阈值和执行动作。）

## 按人和应用追踪用量

- **日志分析**：成员看到自己创建的 Key 的调用；工作空间管理员和账号管理员看到全部调用。团队和企业的日志有「创建人」列，「部门」列可在 **自定义列** 中打开，也可以按 API Key、创建人和部门筛选。
- **用量分析**：「按 API Key」页签比较各 Key 的用量；账号管理员还能看到「按部门」「按用户」。其他成员（包括工作空间管理员）只看到自己创建的 Key 的用量。
- **共享 Key 的归属**：日志中的「创建人」是 Key 的创建人，不是实际发起调用的人。用量分析的「按用户」「按部门」把共享 Key 的用量单列为「共享应用 · 未归属」，需要按人统计时请使用个人 Key。

对账与审计方法见[预算归因与调用审计](https://platform.lyrouter.com/ai_gateway/docs/audit-practice)。