配置 HolyCrab CLI 的 API Key

API Key 已配置并验证有效时,可直接进入在 Codex 中使用;尚未配置时,再按下列步骤操作。API Key 相当于这台电脑使用 HolyCrab 账号的私密密码。不要发到 Codex、源代码、截图或聊天消息里。

配置步骤

1. 打开 API Key 页面

打开 HolyCrab API Key 页面 并登录。没有可用 Key 时创建一个。

HolyCrab API Key 页面,显示已打码的 Key 和状态

选择状态正常的 Key;示例截图不含可用密钥。

2. 复制 API Key

点击网页上的复制按钮。请勿将 Key 粘贴到 Codex 对话或其他聊天窗口。

3. 运行 setup

回到 PowerShell 或终端,运行下面命令。

holycrab setup

4. 粘贴到隐藏输入

看到输入 API Key 的提示后,在那里粘贴并按回车。屏幕不出现圆点或字符是正常的,这是在保护 Key。

5. 确认结果

成功时会显示 Key 已配置并通过验证。以后需要更换 Key,重新运行 setup 即可。

安全提醒

  • 不要把 API Key 发给 Codex、Claude Code、客服或同事。
  • 不要把它放进截图、录屏、提示词或项目文件。
  • 怀疑泄露时,在 API Key 网页撤销旧 Key,再创建并 setup 新 Key。

未成功时

  • Key 被拒绝时,请返回网页确认它仍处于启用状态,再重新运行 setup。
  • 配置的 Key 属于错误账号时,请从正确账号复制 Key 并重新运行 setup。
  • 看到环境变量覆盖提示时,请勿发送任何 Key,并按照常见问题页中的系统指引处理。