创建 API Key
1
打开 API 密钥页面
登录后进入 API 密钥 页面,点击新建。
2
填写名称
名称只用于区分用途,例如
claude-code-mac、团队-测试。3
选择分组
选择包含所需模型的分组。分组决定可用的模型和倍率,见 分组与计费。
4
设置额度和过期时间(可选)
- 额度:这个 Key 最多可以消耗多少站内额度,用完后自动停止调用
- 过期时间:到期后 Key 自动失效
5
复制 Key
创建完成后复制 Key,按对应工具的教程完成配置。
使用建议
一个用途一个 Key
不同工具、设备或成员使用不同的 Key。某个 Key 泄露时只需要删除它,不影响其他用途。
给 Key 设置额度
分享给他人或在测试环境使用的 Key,建议设置额度上限,避免意外消耗。
临时用途设置过期时间
临时演示、短期项目用的 Key,设置过期时间后会自动失效。
按分组拆分
日常任务和重要任务使用不同分组的 Key,兼顾成本和稳定性。
保管 Key
- 不要把 Key 提交到代码仓库,包括项目目录下的
.claude/settings.json、.env等文件 - 不要在截图、聊天记录或公开的 Issue 中暴露 Key
- 在代码中优先通过环境变量读取 Key,不要直接写在源码里
- 怀疑 Key 泄露时,立即在 API 密钥 页面删除或禁用,再创建新的 Key
常见问题
Key 可以更换分组吗
Key 可以更换分组吗
可以在 API 密钥页面编辑 Key 的分组。修改后,正在使用的工具无需改配置即可生效。
提示额度不足,但账户还有余额
提示额度不足,但账户还有余额
检查这个 Key 是否设置了额度上限,且已经用完。在 API 密钥页面提高额度,或改为不限额度。
提示 Key 已过期或已禁用
提示 Key 已过期或已禁用
在 API 密钥页面检查 Key 的状态和过期时间,重新启用或延长有效期。

