跳转到主要内容
所谓自动化令牌可让程序像您在控制台中一样操作工作区：配对连接器、发布模型、创建 API 密钥、查看用量。您在 Settings 中铸造它，精确选择它可执行的操作，并在您指定的日期过期。将它交给 Claude Code 或 Codex 等编程代理、CI 作业或脚本，该程序即可无人值守地完成全部设置。 它不是 API 密钥。API 密钥（sk-tok-…）让客户端调用您的模型。自动化令牌（at-tok-…）让程序管理工作区，且绝不能通过它调用模型。两者互不交叉。
自动化令牌仅作用于您自己的工作区。它们绝不能更改您的密码或邮箱、显示或分享 API 密钥、轮换连接器令牌、读取已存储的提示词、更改请求日志记录，或创建其他自动化令牌。这些操作仍需通过已登录的控制台会话完成。

​
创建令牌

仅工作区管理员可以创建、列出或撤销自动化令牌。
1

打开 Settings

在控制台中，打开 Settings 并滚动到 Automation tokens。点击 Create token。
2

以持有者命名

使用您在令牌列表及其创建的行中能识别的名称，例如 claude-code on my laptop 或 ci-deploy。
3

选择预设或自定义作用域

Setup 是安装连接器并使模型可被调用的代理的正确预设。Read-only 适用于监控。Full 授予所有作用域。其他情况可勾选单独的作用域。参见下方作用域。
4

选择过期时间

每个令牌都会过期。一次性设置运行选择 1 hour，长期任务选择更长时间。最长为 1 year。
5

一次性复制令牌

令牌仅显示一次。将其复制到程序的机密存储或 shell 变量中。如果丢失，从列表中点击 Regenerate；旧值立即失效。

​
作用域

作用域格式为 resource:verb。write 作用域包含对应的 read。没有任何作用域包含 keys:rotate 或 models:reroute。 超出令牌作用域的调用会返回 403，并在错误中指明缺少的作用域，因此程序可以准确告知您它缺少哪项授权。

​
使用令牌

将其作为 Bearer 令牌发送至控制台主机，而非 API 主机。所有管理调用均位于 https://tokios.com/account/ 下。
有关完整调用列表及无人值守设置的调用顺序，请参阅让编程代理为您设置 Tokios。

​
交给代理

使用 Setup 预设和 1 hour 过期时间创建令牌，然后在运行模型的机器上启动代理，并发送以下提示词：
在启动代理之前，先在 shell 中设置 TOKIOS_TOKEN，这样密钥就不会出现在对话中。指南页面会告知代理其他所有信息。

​
管理令牌

在 Settings 中，每一行显示令牌的作用域、指纹、过期时间以及最后一次使用的时间和 IP 地址。
  • Regenerate 替换密钥值。旧值立即失效，新值仅显示一次。
  • Revoke 永久停用令牌。需创建新令牌替代。
  • Delete 从列表中移除已撤销或已过期的令牌。
更改或重置密码会撤销您创建的所有令牌。从被盗会话中铸造的令牌会在您恢复账户后立即失效，任何常驻作业之后都需要新的令牌。 自动化令牌创建的行在 Connectors、Models 和 Keys 选项卡上带有 via token 标记，因此您始终可以分辨程序执行了哪些操作。即使令牌被删除，该标记仍会保留。

​
保障令牌安全

  • 缩小作用域。 已完成任务的 Setup 令牌应被撤销，而非保留。
  • 尽快过期。 交互式代理会话使用 1 hour。长期过期仅适用于机密存储中的常驻任务。
  • 不要出现在对话记录中。 从 shell 变量读取；切勿将其粘贴到与代理的聊天中。
  • 关注标记和最后使用时间列。 如果令牌从您不认识的地址被使用，请撤销它。
  • 了解铸造密钥的含义。 具有 keys:write 的令牌可以创建 API 密钥，且该密钥在令牌过期后仍然有效。窃取 1 小时 Setup 令牌的人可以铸造一个永不过期的密钥并持续调用您的模型，直到您发现。在任何代理运行后，打开 Keys 选项卡，查找标记为 via token 的行，并撤销任何您未预期的行。
  • 仅在需要时授予 models:reroute。 移动、重命名或删除现有模型会改变接收其流量的机器。同时能够配对连接器的令牌可以配对其持有者控制的机器，并把您的模型移到那里。Setup 永远不需要它：它会创建模型，但从不移动模型。
  • 共享地址会共享锁定。 来自同一 IP 地址的令牌失败尝试达到 8 次后，该地址的所有令牌都会被以 429 拒绝，持续 6 分钟，包括有效令牌。位于同一办公网络、NAT 网关或 CI 运行器池后面的代理会共享该锁定。如果某个客户端一直发送错误的令牌，请停止或修复它，而不是让它循环重试。

代理驱动的设置

代理使用 Setup 令牌执行的逐步操作流程。

API 密钥

您的客户端用于调用模型的密钥。