创建访问令牌

访问令牌用于识别 API 调用者，并决定请求可使用的模型、分组和额度。建议每个设备或客户端使用单独的令牌。

创建步骤

1. 登录云枢控制台。
2. 进入“访问令牌”页面，点击“添加令牌”。
3. 填写用途明确的名称，例如 Claude-Code-Windows。
4. 根据需要设置分组、模型范围、额度、IP 或速率限制。
5. 保存后复制令牌，并存放到密码管理器或系统密钥存储中。

API 调用时，令牌通常放在请求头中：

Authorization: Bearer sk-your-token

Anthropic Messages 接口也接受 x-api-key：

x-api-key: sk-your-token
anthropic-version: 2023-06-01

推荐的划分方式

用途	建议名称	原因
Claude Code	Claude-Code-Laptop	可单独停用和排查日志
Codex	Codex-Desktop	与聊天客户端隔离额度
Cherry Studio	Cherry-Studio	便于识别桌面会话
服务端应用	Production-App	可设置独立额度与 IP 限制

不要让多个公开服务共享同一个令牌。任一服务泄露都会影响全部调用。

限制建议

• 初次接入时先设置较小额度，验证成功后再调整。
• 只授权客户端实际需要的模型。
• 固定出口 IP 的服务端应用可以启用 IP 白名单。
• 为自动化任务设置合理的速率限制，避免异常循环持续消耗额度。
• 停用不再使用的令牌，不要只删除本地配置。

安全提示

• 不要把令牌直接写进代码；使用环境变量或密钥管理服务。
• 不要提交 .env、auth.json 或包含令牌的 config.toml。
• 不要在截图、聊天记录、Issue 或工单中暴露完整令牌。
• 怀疑泄露时，立即在控制台禁用或删除令牌，并创建新令牌。

环境变量示例

macOS / Linux 当前终端：

export OPENAI_API_KEY="sk-your-token"

Windows PowerShell 当前终端：

$env:OPENAI_API_KEY = "sk-your-token"

环境变量只对当前终端及其启动的程序生效。需要长期使用时，请按照对应客户端教程进行持久化配置。