开发者密钥

谁可以创建密钥

开发者密钥属于你的 ToRun 账户。要创建密钥，你的账户需要：

• 已验证的电子邮件地址，
• 付费套餐或已购余额，因为免费额度从不为 API 调用付费。

创建密钥

1. 打开你 ToRun 账户的开发者页面。
2. 点击 创建密钥 并填写表单：
   • 名称：能让你知道密钥用在哪里的名称，例如“我笔记本电脑上的 opencode”。
   • 每月消费上限（Runs）：此密钥一个月内最多可以花费的数额。
   • 单次生成超过此值时先询问（Runs）：费用超过此值的生成会先询问你。
   • 当我的套餐额度用完时，允许此密钥从我的钱包消费：如果密钥只应使用你的套餐额度，请保持关闭。
3. 通过安全验证并创建密钥。
4. 复制密钥。它只显示一次。

不要把密钥放进文件

把密钥保存在名为 TORUN_API_KEY 的环境变量中，并让工具的配置引用这个变量，而不是把密钥直接粘贴进去。

macOS 和 Linux，在你的 shell 配置文件中（例如 ~/.zshrc 或 ~/.bashrc）：

export TORUN_API_KEY="trn_live_..."

Windows，在 PowerShell 中（然后打开一个新的终端）：

setx TORUN_API_KEY "trn_live_..."

切勿把密钥提交到代码仓库，也不要把它放进你会分享的配置文件中。

查看和撤销

开发者页面列出你的密钥，显示每个密钥本月相对其上限已花费多少、上次使用的时间以及是否有效。上次使用时间每隔几分钟更新一次，因此如果有你不认识的密钥正在使用，会在那里显示出来。

撤销 会立即停用密钥：使用它的工具在下一次调用时会被拒绝。如果密钥可能已经泄露，请撤销它并创建一个新密钥。

一个账户可以持有的有效密钥数量和每天可以创建的密钥数量都有限制。

下一步

• ToRun MCP 服务器：各工具的作用以及调用如何付费。
• 连接工具：opencode、Claude Code、Cursor。