Source: https://wiki.niceai.dev/guide/key-security

# API 密钥安全最佳实践

API 密钥等同于账户余额的支付凭证，谁拿到就能用你的余额调用模型。基本原则：**密钥只放在环境变量或服务端配置里，不写进代码、不提交到 Git、不放进前端、不截图分享**；一旦怀疑泄露，立刻在控制台删除或禁用并重新创建。

## 1. 用环境变量，不要写死在代码里

**-group**

```bash [macOS / Linux]
# 写入 ~/.zshrc 或 ~/.bashrc 后重新打开终端
export NICEAI_API_KEY="sk-你的密钥"
```

```powershell [Windows PowerShell]
# 写入当前用户的环境变量，重新打开终端后生效
[Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")
```

```python [代码中读取]
import os
api_key = os.environ["NICEAI_API_KEY"]
```



项目里用 `.env` 文件时，记得把它加进 `.gitignore`：

```text
# .gitignore
.env
.env.*
!.env.example
```

再提交一个不含真实密钥的 `.env.example`，告诉协作者需要哪些变量。

## 2. 不要把密钥放进前端

网页、小程序、浏览器插件、桌面应用安装包里的任何字符串，用户都能看到。正确做法是在自己的服务端转发请求：前端调用你的后端，后端带上密钥去请求 NiceAI，并在后端做登录校验和频率限制。

## 3. 按用途分开创建密钥

在控制台「[API 密钥](https://niceai.dev/keys)」页面，可以为不同工具、项目分别创建密钥，例如 Claude Code 一个、Cursor 一个、线上服务一个。好处是：

- 某个密钥泄露时，只需要删除这一个，不影响其他工具。
- 在使用记录里更容易看出是哪个工具在消耗额度。

密钥是否支持设置额度、有效期等限制，以控制台的实际选项为准。

## 4. 这些地方最容易泄露

| 场景 | 建议 |
| --- | --- |
| 把含密钥的配置文件提交到 GitHub | 用环境变量；提交前检查 `git diff`；仓库开启密钥扫描 |
| 截图、录屏分享配置界面 | 截图前把密钥打码，录屏时避开设置页 |
| 在群聊、论坛里贴报错日志 | 日志里的请求头可能带有密钥，贴之前搜一下 `sk-` |
| 把 `~/.claude/settings.json`、`~/.codex` 等目录整个打包发给别人 | 这些文件可能含有密钥，发之前删掉或替换 |
| 使用来路不明的“免费代理”“共享面板” | 只在可信的客户端里填写密钥 |

## 5. 怀疑泄露后怎么办

1. 立即在控制台「[API 密钥](https://niceai.dev/keys)」页面删除或禁用该密钥。
2. 创建新密钥，替换到各个工具和服务里。
3. 在使用记录里查看异常时间段的调用情况。
4. 如果密钥曾提交到 Git，仅删除文件不够，历史记录里仍然有，要以“已泄露”处理并更换密钥。
5. 发现异常消耗时，记下时间和密钥名称联系客服。

## 下一步

- [快速开始](https://wiki.niceai.dev/guide/quick-start)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
- [限流、超时与重试](https://wiki.niceai.dev/guide/api/rate-limits)
