纳米AI API Key环境变量配置教程

应使用环境变量配置纳米AI密钥，并禁止硬编码。这样可以减少密钥泄露风险，也便于后续统一管理和替换。

不同系统的配置方式

• Linux / macOS
  ：将环境变量写入 ~/.zshrc 或 ~/.bashrc，然后执行 source 让配置立即生效。

• Windows
  ：使用 setx 设置系统变量，之后需要重启终端才能读取到新配置。

验证是否配置成功

• 通过 env 查看环境变量是否存在。
• 在 Python 中使用 os.getenv 读取密钥，确认返回值正确。
• 也可以使用 curl 调用接口，检查是否能够正常认证并获取响应。

如果终端中仍然读取不到变量，先检查是否已经执行 source，Windows 则确认是否已重新打开命令行窗口。

如果接口调用失败，优先确认环境变量名是否写错、密钥内容是否完整，以及当前终端会话是否已经加载最新配置。

你需要让本地开发环境或命令行工具能自动识别纳米AI的API密钥，避免每次调用都手动传参，防止密钥硬编码进代码导致泄露。

确认密钥已正确获取

访问 纳米AI开发者平台 → 登录账号 → 进入「API管理」→ 点击「创建新密钥」→ 勾选 nano-chat 和 nano-search 权限 → 复制生成的完整密钥字符串。【

】

密钥应以 sk-、or- 或 fw- 开头；若以 pk_ 或 rk_ 开头，说明你复制的是前端公钥，需返回平台重新生成服务端私钥。

Linux/macOS：写入 shell 配置文件

第一步：打开终端，根据当前使用的 shell 写入环境变量。macOS Catalina 及以后默认使用 zsh，可执行 echo "export NANO_AI_API_KEY=sk-xxxxxxxx" >> ~/.zshrc；如果是旧版 macOS 或多数 Linux 发行版，可执行 echo "export NANO_AI_API_KEY=sk-xxxxxxxx" >> ~/.bashrc。

第二步：运行 source ~/.zshrc 或 source ~/.bashrc 使配置立即生效。

第三步：执行 echo $NANO_AI_API_KEY，确认输出为完整密钥字符串。如果为空，请检查是否写入了错误的配置文件（比如在 ~/.bashrc 中写入却用 zsh 启动终端）。

Windows：用 PowerShell 设置系统级变量

以管理员身份打开 PowerShell，执行：
setx NANO_AI_API_KEY "sk-xxxxxxxx"

⚠️ 执行后必须关闭并重新打开所有 PowerShell、CMD 和 IDE 窗口，否则变量不会被新进程读取。Codex、Trae 或自研脚本启动时若仍报 401 错误，大概率是没重启终端。

验证是否生效（通用方法）

方法一：在终端中运行 env | grep NANO_AI_API_KEY（Linux/macOS）或 echo %NANO_AI_API_KEY%（Windows CMD），看到密钥即表示成功。

方法二：新建 Python 脚本 test_env.py，内容为：

import os
print(os.getenv("NANO_AI_API_KEY"))

运行 python test_env.py，输出应为密钥全文。

方法三：直接调用纳米AI搜索接口测试：

curl -X POST https://api.nano-ai.com/search/v1/query \
  -H "Authorization: Bearer $(echo $NANO_AI_API_KEY)" \
  -H "Content-Type: application/json" \
  -d '{"query":"纳米AI支持哪些模型"}'