Manage Providers and Credentials¶

AI 代理通常需要憑證才能存取外部服務：例如，AI 模型提供者的 API 金鑰, GitHub 或 GitLab 的令牌等等。 OpenShell 將這些憑證作為名為「提供者 (Provider)」的 first-class 實體進行管理。

建立和管理向沙箱提供憑證的提供者。

Create a Provider¶

可以透過本機環境變數或明確憑證值建立提供者。

From Local Credentials¶

建立提供者最快的方法是讓 CLI 從 shell 環境中發現憑證：

openshell provider create --name my-claude --type claude --from-existing

此操作會從目前環境中讀取 ANTHROPIC_API_KEY 或 CLAUDE_API_KEY，並將其儲存在提供者中。

With Explicit Credentials¶

直接提供憑證值：

openshell provider create --name my-api --type generic --credential API_KEY=sk-abc123

Bare Key Form¶

傳遞一個不帶值的鍵名，即可從該鍵名的環境變數讀取值：

openshell provider create --name my-api --type generic --credential API_KEY

這段程式碼會在你的 shell 中尋找 $API_KEY 的目前值並將其儲存起來。

Manage Providers¶

列出, 檢查, 更新和刪除活動群集中的提供者。

列出所有提供者：

openshell provider list

檢查服務提供者：

openshell provider get my-claude

更新服務提供者的憑證：

openshell provider update my-claude --type claude --from-existing

刪除服務提供者：

openshell provider delete my-claude

Attach Providers to Sandboxes¶

建立沙箱時，可以傳遞一個或多個 --provider 旗標：

openshell sandbox create --provider my-claude --provider my-github -- claude

每個 --provider 旗標都會附加一個提供者。沙箱會在運作時接收所有已附加提供者的全部憑證。

Auto-Discovery Shortcut¶

當 openshell sandbox create 命令的末尾命令是可識別的工具名稱（例如 claude, codex 或 opencode）時，如果所需的提供者尚不存在，CLI 會自動使用您的本機憑證建立該提供者。您無需單獨建立提供者：

openshell sandbox create -- claude

這會將 Claude 偵測為已知工具，找到您的 ANTHROPIC_API_KEY，建立一個提供程序，將其附加到沙箱，並啟動 Claude Code。

Supported Provider Types¶

支援以下幾種提供者類型。

Supported Inference Providers¶

以下提供者已通過 inference.local 測試。任何提供 OpenAI 相容 API 的供應商均可與 openai 類型搭配使用。請將 --config OPENAI_BASE_URL 設定為提供者的基本 URL，並將 --credential OPENAI_API_KEY 設定為您的 API 金鑰。

請參閱服務提供者的文檔，以取得正確的基本 URL、可用模型和 API 金鑰設定。若要設定模型推論路由，請參閱「設定推論路由」部分。