> ## Documentation index
> Fetch the complete documentation index at: https://docs.manyfold.ai/zh/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型提供方

> 连接 Anthropic、OpenAI、Google Gemini、OpenRouter 或托管模型额度。

Source: https://docs.manyfold.ai/zh/docs/model-providers/

模型提供方让 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](/zh/docs/create-agent/) 时，从创建流程中选择已保存的提供方。

## 提供方标签

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

- `personal`
- `engineering-team`
- `staging`
- `managed`

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

## 轮换密钥

如果密钥被吊销或替换：

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

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

## 排查问题

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

## 另请参阅

- [创建第一个 Agent](/zh/docs/create-agent/)
- [使用工作区](/zh/docs/workspace/)
- [常见问题](/zh/docs/faq/)