---
title: 获取与管理 API 密钥
description: 在 1折AI 控制台创建 sk- 开头的 API 密钥，以及怎么存放、轮换、在泄露时止损。
---

一个 API 密钥（API key）对应一份调用权限，扣的是你账户的余额。这页讲怎么建、怎么放、出事了怎么办。

## 创建 API 密钥

<Steps>
<Step title="登录控制台">

打开 [1zheai.com/console](https://1zheai.com/console)。

</Step>
<Step title="新建">

左侧菜单点「API 密钥」，再点右上角「创建 API 密钥」。名称填一个能看出用途的名字，比如 `claude-code-macbook`、`ci-staging`，其它项不改也能用，点「保存更改」。

表单里可以设置的项：

| 表单项 | 默认 | 说明 |
|---|---|---|
| 名称 | 空 | 调用日志里按这个名字区分 API 密钥 |
| 过期时间 | 永不过期 | 可选 1 小时、1 天、1 个月，或指定具体日期和时间 |
| 数量 | 1 | 一次建多个，名称会自动加随机后缀 |
| 「无限配额」开关 | 打开 | 关掉后出现「额度 (USD)」，这个 API 密钥最多只能花这么多美元 |
| 模型限制（在「高级设置」里） | 空，表示所有模型都能用 | 选了模型后，这个 API 密钥只能调这些模型 |
| IP 白名单（在「高级设置」里） | 空，表示不限 | 只允许列出的 IP 或 CIDR 网段调用 |

</Step>
<Step title="复制保存">

API 密钥以 `sk-` 开头。复制后放进密码管理器或环境变量，不要贴进聊天、截图或代码仓库。

</Step>
</Steps>

## 一个工具一个 API 密钥

建议每个工具、每台机器各建一个 API 密钥。好处有三个：

- 调用日志按 API 密钥区分，哪个工具花了多少钱一眼能看出来。
- 某个 API 密钥泄露了，只删那一个，其它工具不受影响。
- 团队里谁的 API 密钥谁负责，离职或换机器时删除对应的 API 密钥。

## 放在哪里

<CodeGroup>
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
</CodeGroup>

<Warning>

Claude Code 的项目级 `.claude/settings.json` 通常会提交进仓库，Claude Code 官方文档也明确建议不要把凭据写在这里。API 密钥放用户级的 `~/.claude/settings.json`，或者项目里不提交的 `.claude/settings.local.json`。

</Warning>

## 泄露了怎么办

1. 在「API 密钥」列表里找到它，点「操作」列的「禁用」图标，或者在「⋯」菜单里选「删除」。禁用后立刻失效，再用它调用会返回 401 `Invalid token`。
2. 新建一个 API 密钥，换到用到它的地方。
3. 打开调用日志（控制台菜单「使用日志」），点「展开」，在「令牌名称」里填这个 API 密钥的名字筛选，看最近的调用里有没有不是你发起的。

## 常见问题

<AccordionGroup>
<Accordion title="API 密钥能同时给 Claude Code 和 Cursor 用吗？">

能，API 密钥不绑定工具。只是混用以后日志里分不清是谁花的，所以还是建议分开建。

</Accordion>
<Accordion title="提示 Invalid token / 401 是 API 密钥的问题吗？">

多数是。常见原因：复制时带了空格或换行、API 密钥已删除、填进了工具里错误的字段。逐项排查见[错误码与排错](/docs/troubleshooting/)。

</Accordion>
<Accordion title="API 密钥会过期吗？">

默认永不过期。创建或编辑时可以在「过期时间」里设一个时间，过期后再调用返回 401 `Invalid token`，和 API 密钥写错时的回包一样。列表的「过期」列显示每个 API 密钥的过期时间。

</Accordion>
</AccordionGroup>