01 / 先弄清四件事
一次调用需要什么？
无论使用哪种工具，最终都离不开下面四项。先理解它们，遇到问题时就知道该检查哪里。
Zivv 账号
用于充值、创建 Key、查看用量和管理账单。
API Key
以 sk- 开头的访问凭证。它代表你的账号，不要公开或发给他人。
API 地址
OpenAI 兼容工具通常使用 https://zivv.pro/v1；Claude Code 使用 https://zivv.pro。
模型名称
模型决定能力、速度和费用。请从模型广场复制当前可用名称。
02 / 选择模型
按任务选，不必追最贵
模型更新很快，具体名称和价格以模型广场为准。新手先按用途选择，再根据实际效果调整。
Claude
Claude Code、复杂代码、长文档
编码工作优先从 Claude Sonnet 系列开始；复杂任务再考虑更强型号。
GPT
Codex、OpenAI SDK、通用任务
需要 OpenAI 兼容工具或通用能力时，从 GPT 主流型号开始。
Gemini
长上下文、图片和多模态内容
需要处理大量材料或图文输入时，选择 Gemini 系列。
03 / 创建 Key
四步完成准备
把每个 Key 当作密码保管
不要把 Key 写进公开仓库、截图、群聊或前端网页。怀疑泄露时，立即删除旧 Key 并创建新的。
04 / 完成第一次调用
选择你的使用方式
下面三种方式共用同一个 Zivv 账号，但填写的 API 地址不同。
Claude Code
创建 Key 时选择适合 Claude 的分组，然后设置两个环境变量。重新打开终端后启动 Claude Code。
export ANTHROPIC_BASE_URL=https://zivv.pro export ANTHROPIC_AUTH_TOKEN=sk-your-key
Windows PowerShell、macOS 和 Linux 的写法不同，请按完整文档选择对应命令。
Claude Code 配置文档 →05 / 出错时先看这里
四类常见问题
401Key 无效
检查是否复制完整、是否多了空格、Key 是否已被删除。不要把登录密码当成 API Key。
404地址或模型不对
OpenAI 工具通常需要 /v1；Claude Code 不加 /v1。模型名称应从模型广场复制。
429请求暂时受限
先降低并发并稍后重试；持续出现时查看状态页或联系支持。
余额调用停止
检查余额和 Key 的额度限制，再到用量页面确认最近一次请求是否产生记录。
仍然无法解决？带上时间、使用工具、模型名称和错误信息联系支持，但不要发送完整 Key。
联系支持 →06 / 常见问题
开始前再确认
需要每个模型单独创建 Key 吗？
通常不需要。同一个 Key 可以按其分组和权限调用多个模型，具体可用范围以创建 Key 时的设置为准。
充值多少合适？
新手建议先小额充值，用自己的真实任务测试模型、速度和费用，再决定后续用量。
为什么网页能登录，工具却提示 401？
网页登录和 API Key 是两套凭证。工具中要填写 API 令牌页面创建的 sk- Key，而不是账号密码。
可以把 Key 放在浏览器网页里吗？
不要把私密 Key 放进公开前端代码。个人工具应使用本地安全存储，团队场景应为成员分别创建 Key 和额度。