模型提供方

模型提供方让 Agent 可以访问所需模型。你可以保存一次提供方凭证，并在创建 Agent 时复用。

支持的提供方

提供方	常见用途
Anthropic	Claude Code
OpenAI	Codex
Google Gemini	Gemini CLI
OpenRouter	模型路由和兼容模型访问

你的工作区也可能有托管模型额度。如果有，创建流程会展示可用选项，而不要求你粘贴个人 API key。

添加提供方密钥

1. 打开 Settings -> Model providers。
2. 选择提供方。
3. 添加标签，例如 personal 或 team。
4. 粘贴 API key。
5. 除非你使用兼容的自定义 endpoint，否则让 Base URL 保持为空。
6. 测试连接。
7. 保存提供方。

创建 Agent 时，从创建流程中选择已保存的提供方。

提供方标签

标签应该说明归属或预算边界：

• personal
• engineering-team
• staging
• managed

避免在标签中包含 secret、客户名称或一次性任务名称。

轮换密钥

如果密钥被吊销或替换：

1. 打开设置中的提供方记录。
2. 粘贴新密钥。
3. 测试连接。
4. 保存提供方。
5. 重试失败的 Agent 操作。

保存后，已有 Agent 会使用更新后的提供方连接。

排查问题

• 测试连接失败：确认密钥属于所选提供方，并且有模型访问权限。
• 创建 Agent 时要求提供方：为所选框架添加兼容的提供方。
• 模型列表为空：检查账户账单、模型权限和自定义 Base URL。
• 费用不符合预期：查看 Settings -> Usage，确认 Agent 使用的是预期的提供方和模型。