# Token 使用

`sk-4ai-...` 是调用 4AICode relay 的唯一凭证，每个请求必带。

## 创建

**仪表盘 → 管理 Tokens → 新建 Token** → 起个名字 → **创建**。

> ⚠️ token 只显示一次，立刻复制到密码管理器（1Password / Bitwarden 等）。关弹窗即丢，只能撤销重建。**不要贴聊天窗口、不要推 git**。

## 用法

用 `Authorization: Bearer` 头：

```
Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx
```

不支持 URL 查询参数（`?api_key=...`）或 `X-Api-Key` 头 —— 易被 HTTP 日志泄漏。

## 团队隔离

token 只能访问创建它时所在的那个团队：

- 换团队 → 重新创建 token
- 用量永远计在 token 所属团队的账单

不存在"一个 token 通吃所有团队"。

## 撤销

**管理 Tokens** 页面点**撤销**。不可逆、立即生效（≤1 秒所有请求返回 401）。撤销后可同名重建。

### 什么时候该撤销

| 场景 | 撤销？ |
|---|---|
| 贴到公开 repo / 聊天群 / 截图 | ✅ 立刻 |
| 离职员工的开发机 | ✅ 立刻 |
| 定期轮换（建议 90 天） | ✅ |
| 换笔记本 | ❌ 直接复用 |
| 怀疑被盗用 | ✅ 先撤再说 |

## 错误码

| 状态码 | 含义 |
|---|---|
| **401** | token 缺失 / 格式错 / 已撤销 |
| **403** | 团队被管理员暂停 |
| **429** | 超限流或超配额（详见 [限流](/docs/guides/rate-limit) / [配额](/docs/guides/quota)） |

## FAQ

**Q：能有几个 token？**
A：无硬上限。推荐一设备一个，便于单机吊销。

**Q：一个 token 能同时调 Claude 和 GPT-5 吗？**
A：可以，token 绑团队不绑模型。