# 如何使用自己的 API 密钥？ (/zh/connect/use-your-own-keys)



## 什么是 BYOK（使用自己的密钥）？ [#什么是-byok使用自己的密钥]

默认情况下，Helio 中的 AI 队友通过 Helio 托管的访问运行——Helio 提供 API 连接，使用费用计入你的 Helio 套餐。使用自己的密钥（也叫 bring-your-own-key，BYOK）可以让你改为连接自己的 Anthropic、OpenAI 或 DeepSeek 账户——用 API 密钥，或者已有的 Claude Code、ChatGPT 订阅——这样队友的使用量就走你自己的预算和账户，而不是 Helio 托管访问。

<LivePreview component="ModelsSettings" />

## 为什么使用自己的密钥很重要 [#为什么使用自己的密钥很重要]

### 问题：Helio 托管访问不适合所有场景 [#问题helio-托管访问不适合所有场景]

Helio 托管访问作为默认选项很好用，但不是每个团队都适合。有些团队已经自己付费使用 Anthropic、OpenAI 或 DeepSeek 账户，不想再产生一份账单。有些团队已经有 Claude Code 或 ChatGPT 订阅，闲置在那里没有用上。有些需要只能通过直接 API 访问才能用到的模型。还有些希望所有调用都走自己能控制的账户，而不是共用账户。

### 方案：带入自己的凭据 [#方案带入自己的凭据]

使用自己的密钥，把服务商凭据——API 密钥或 subscription login——连接到你的工作区，再分配给需要用它的 AI 队友。从那一刻起，这个队友的使用量就计入你自己的账户，而不是 Helio 托管访问。

## 使用自己的密钥如何运作 [#使用自己的密钥如何运作]

凭据存储在 Helio 的凭据库中，静态加密，仅用于代表 AI 队友进行 API 调用——初次输入后，Helio 不会再次显示凭据值。每位 AI 队友使用一组凭据：让多个队友选择同一个工作区凭据即可共享一份服务商预算，也可以为每位队友设置各自的凭据。邀请真人成员不会自动导入对方自己的 API 密钥。

## 支持的凭据类型 [#支持的凭据类型]

| 提供商           | 选项                      |
| ------------- | ----------------------- |
| **Anthropic** | API 密钥，或 Claude Code 订阅 |
| **OpenAI**    | API 密钥，或 ChatGPT 订阅     |
| **DeepSeek**  | API 密钥                  |

## 真实场景 [#真实场景]

* **已经有 Anthropic 或 OpenAI 账户？** 直接连接 API 密钥，让 Claude Code 或 Codex 队友使用你自己的账户和账单运行，而不是走 Helio 托管访问。
* **已经在付费使用 Claude Code 或 ChatGPT 订阅？** 用 subscription login 代替单独的 API 密钥，避免重复付费。
* **想要更省成本的模型访问？** 连接 DeepSeek API 密钥，获得更经济的兼容模型访问。
* **不同团队或项目需要分开预算？** 添加多个带清晰标签的工作区凭据，比如 `prod-anthropic` 或 `growth-openai`，再给每位 AI 队友分配对应的凭据。
* **想要多个队友共用一份服务商预算？** 添加一个工作区凭据，让多个 AI 队友选择这个凭据下的模型。

## 好处 [#好处]

| 好处     | 说明                                  |
| ------ | ----------------------------------- |
| 成本控制   | 通过你自己的 API 账户路由使用，使用你自己的限额和计费       |
| 复用现有订阅 | 直接使用你已经付费的 Claude Code 或 ChatGPT 订阅 |
| 特定模型访问 | 解锁只能通过直接 API 访问的模型                  |
| 隐私偏好   | 所有调用都通过你自己的账户                       |

## 使用自己密钥的建议 [#使用自己密钥的建议]

| 建议                 | 说明                                                                       |
| ------------------ | ------------------------------------------------------------------------ |
| 标签写清楚              | 用标签说明这份预算属于谁或用于什么场景，比如 `prod-anthropic`——这是之后队友在模型选择器里看到的内容              |
| key 要和 provider 匹配 | 即使模型名看起来相似，粘贴的 key 也必须和生成它的服务商一致                                         |
| 分配前先确认引擎兼容         | Anthropic key 主要用于 Claude Code 队友，OpenAI key 主要用于 Codex 队友——分配前先确认队友引擎兼容 |
| 换密钥而不是复用           | 如果 key 泄露、过期或需要换 owner，先在服务商控制台轮换，再回 Helio 更新凭据                          |

## 常见问题 [#常见问题]

**邀请真人成员会共享对方的个人 API 密钥吗？**
不会。邀请真人成员不会自动导入对方自己的 Anthropic、OpenAI 或 DeepSeek 密钥——工作区凭据需要由工作区管理员单独添加。

**能不能用订阅代替 API 密钥？**
可以，Claude Code 和 ChatGPT 都支持。如果你已经付费使用其中一个订阅，可以用 subscription login 代替单独的 API 密钥。

**保存后 Helio 还会再显示我的 API 密钥吗？**
不会。提交后 Helio 不会再次显示 API key 明文。如果 key 泄露、过期或需要换 owner，请先在服务商控制台轮换，再回 Helio 更新凭据。

**多个 AI 队友能共用同一个凭据吗？**
可以。让多个 AI 队友选择同一个工作区凭据，就能共用一份服务商预算；也可以为每位队友设置各自的凭据分开计费。

**如果我的服务商不在内置列表里，比如 DeepSeek，怎么办？**
以兼容的自定义 endpoint 方式接入。比如 DeepSeek 就不在内置服务商列表里（OpenAI、Anthropic、OpenRouter、AWS Bedrock、Azure），需要通过 Custom 选项填写它的 API endpoint 来添加。

<Cards>
  <Card title="Anthropic API 密钥" href="/connect/use-your-own-keys/connect-anthropic-api-key" description="连接你的 Anthropic 账户或 API 密钥。" />

  <Card title="OpenAI API 密钥" href="/connect/use-your-own-keys/connect-openai-api-key" description="连接你的 OpenAI 账户或 API 密钥。" />

  <Card title="DeepSeek" href="/connect/use-your-own-keys/connect-deepseek-api-key" description="连接你的 DeepSeek API 密钥。" />

  <Card title="共享 API 凭据" href="/connect/use-your-own-keys/share-api-credentials" description="说明成员加入后，哪些 API 凭据会共享，哪些不会。" />

  <Card title="订阅登录" href="/connect/use-your-own-keys/connect-claude-code-chatgpt-subscription" description="使用你的 Claude Code 或 ChatGPT 订阅。" />
</Cards>
