開發者金鑰

誰可以建立金鑰

開發者金鑰屬於你的 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。