先确认哪个进程发送请求，再配置密钥。这里集中处理环境与依赖，后续各工具教程直接复用，不要求把密钥粘进 AI 对话。
- 1. 确认执行器本地、容器或远程
- 2. 准备 API Key只用于 API
- 3. 注入变量不写入共享文件
- 4. 检查存在不输出变量值
1. 登录正确的 API 控制台
复制自己的 API Key，检查余额与首次调用预算。这不是模型 Key，也不是代理用户名或密码。不要把截图中的密钥发给客服或 AI。
2. 在实际执行环境配置
以下命令只对当前终端及其后续启动的子进程有效。先完成配置，再从同一终端启动 CLI；编辑器、容器和远程服务的变量需另行确认。
Windows PowerShell
$secret = Read-Host "Cloudbypass API key" -AsSecureString
$env:CLOUDBYPASS_APIKEY = [System.Net.NetworkCredential]::new("", $secret).Password
$env:TARGET_URL = "https://example.com/"
python -c "import os; print('Key configured:', bool(os.getenv('CLOUDBYPASS_APIKEY')))"macOS / Linux Bash
read -r -s -p "Cloudbypass API key: " CLOUDBYPASS_APIKEY
echo
export CLOUDBYPASS_APIKEY
export TARGET_URL="https://example.com/"
python3 -c "import os; print('Key configured:', bool(os.getenv('CLOUDBYPASS_APIKEY')))"3. 使用项目自己的 Python 环境
已有项目优先使用已有依赖环境。新目录可创建虚拟环境，再用同一个解释器安装 requests；命令本身不调用穿云 API。
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install requestspython3 -m venv .venv
./.venv/bin/python -m pip install requests4. 不要泄露到仓库或日志
- 共享文件只保留变量名或空占位符，.env 等本地配置先加入 .gitignore。
- 不要执行 printenv、输出所有请求头或把密钥拼进 URL。
- 如果误公开，先撤销或轮换密钥，再清理日志和历史；仅删除当前一行不够。
- 使用 n8n 凭据或 Dify Secret 时，配置在服务端执行环境，不放在用户输入中。
常见问题
检查结果为 false 怎么办？
确认实际使用的终端、解释器和进程；变量不会自动传给此前启动的应用。
网页前端可以直接调用吗？
不要把 Key 放在浏览器代码里。由自己的后端读取密钥，再把必要业务结果交给前端。
代理密码也放这里吗？
需要代理时按当前接口文档单独安全配置；不要混淆本地系统代理与 x-cb-proxy。