纳米AI API Key环境变量配置操作步骤

应使用环境变量配置纳米AI密钥，禁止硬编码；Linux/macOS写入~/.zshrc或~/.bashrc并source生效，Windows用setx设系统变量并重启终端；验证需通过env、Python os.getenv或curl调用接口确认。

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

确认密钥已正确获取

访问 纳米AI开发者平台 → 登录账号 → 进入「API管理」→ 点击「创建新密钥」→ 勾选 nano-chat 和 nano-search 权限 → 复制生成的完整密钥字符串。【必须用页面上的「Copy」按钮复制，手动输入或截断末尾字符会导致401认证失败】

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

Linux/macOS：写入 shell 配置文件

第一步：打开终端，执行 echo "export NANO_AI_API_KEY=sk-xxxxxxxx" >> ~/.zshrc（macOS Catalina 及以后默认使用 zsh）或 echo "export NANO_AI_API_KEY=sk-xxxxxxxx" >> ~/.bashrc（旧版 macOS 或多数 Linux 发行版）。

第二步：运行 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支持哪些模型"}'