使用教程
AI 编程工具安装与配置指南
平台 API 地址
v1OPENAI · COMPATIBLE · ENDPOINT
$https://your-domain.com/api/nexura/v1select · tools
选择您要使用的工具
当前仅 Claude Code 已上线，其他工具敬请期待
install · script
安装脚本
请在终端中运行此脚本
curl -s https://nexura.startupper.space/setup-claudecode.sh | bash -s -- --url https://nexura.startupper.space/api/nexura --key nxr-xxxxxxxxxxxx本脚本会自动检测系统环境，安装必要的依赖，并完成环境变量的配置。脚本执行成功后，请重新打开终端，开始使用。
请在 PowerShell 中以管理员身份运行
& { $url="https://nexura.startupper.space/api/nexura"; $key="nxr-xxxxxxxxxxxx"; iex ([Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://nexura.startupper.space/setup-claudecode.ps1'))) }本脚本会自动检测系统环境，安装必要的依赖，并完成环境变量的配置。脚本执行成功后，请重新打开 PowerShell，开始使用。如果提示无权限，请以管理员身份运行【Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force】，再重新运行脚本。
catalog · models
可用模型列表
以下为平台当前可用的模型，在工具中使用时请填写对应的模型标识符（Model ID）。
reference · errors
错误码参考
| 错误码 | HTTP | 含义 | 常见原因 | 解决建议 |
|---|---|---|---|---|
AI0001 | 400 | 无效请求 | 请求体格式错误或缺少必填字段 | 检查请求体 JSON 格式和必填参数 |
AI0002 | 401 | 无效的 API Key | API Key 不存在或格式错误 | 检查 API Key 是否正确，确认环境变量设置 |
AI0003 | 403 | API Key 已禁用 | Key 被管理员禁用或已撤销 | 联系管理员或创建新的 API Key |
AI0004 | 403 | 额度已耗尽 | 账户可用额度不足 | 购买套餐或充值额度 |
AI0005 | 429 | 请求频率超限 | 超过 API Key 或分组的 RPM 限制 | 降低请求频率或升级分组 |
AI0006 | 400 | 模型不存在 | 请求的模型标识符不在平台模型列表中 | 检查模型名称拼写，参考下方可用模型列表 |
AI0007 | 403 | 无权使用该模型 | 当前分组或套餐不包含该模型 | 升级套餐或联系管理员开通权限 |
AI0008 | 502 | 上游服务错误 | 供应商 API 返回错误 | 稍后重试，若持续出现请联系管理员 |
AI0009 | 504 | 上游服务超时 | 供应商 API 响应超时 | 减少输入长度或稍后重试 |
AI0010 | 503 | 无可用渠道 | 所有渠道均不可用或维护中 | 稍后重试，若持续出现请联系管理员 |
AI0011 | 400 | 参数校验失败 | 请求参数不符合要求 | 检查参数类型和取值范围 |
AI0012 | 413 | 内容过大 | 请求体超过大小限制 | 减少输入内容长度 |
AI0013 | 500 | 内部服务错误 | 平台内部异常 | 稍后重试，若持续出现请联系管理员 |
AI0014 | 402 | 余额不足 | 预扣额度时发现余额不够 | 充值或购买套餐 |
AI0015 | 429 | 并发数超限 | 同时进行的请求数超过分组限制 | 等待当前请求完成后再发起新请求 |
help · faq
常见问题
执行 claude 命令提示「找不到命令」怎么办？
Windows 用户请确认 PowerShell 以管理员身份运行安装脚本；macOS/Linux 用户请重新打开终端或执行 source ~/.zshrc（或 ~/.bashrc）。如果使用 npm 安装，请确认 Node.js 全局 bin 目录在 PATH 中。
执行 codex 命令提示「找不到命令」怎么办？
请确认 Node.js 版本 ≥ 18（执行 node --version 检查），并确认 npm 全局安装目录在系统 PATH 中。Windows 用户可尝试重启 PowerShell，macOS/Linux 用户可执行 npm config get prefix 查看全局目录。
工具连接平台失败怎么办？
请检查：1) 环境变量 OPENAI_API_KEY 和 OPENAI_BASE_URL 是否正确设置；2) API Key 是否有效（未被撤销）；3) 网络是否能访问平台地址。可以用 curl 命令测试连通性。
如何在工具中指定使用的模型？
Claude Code 使用 --model 参数指定模型（如 claude --provider openai --model gpt-4o）；Codex CLI 使用 --model 参数（如 codex --model gpt-4o）。可用模型请参考上方模型列表。
使用过程中提示额度不足怎么办？
进入平台「仪表盘」查看剩余额度，如已耗尽可购买套餐或使用兑换码充值。AI 编程工具消耗 Token 较多，建议选择额度充足的套餐。
遇到限流 (429) 错误怎么处理？
工具通常会自动重试。如果频繁出现，说明请求频率超过分组限制，建议：1) 减少并发操作；2) 升级到更高分组获得更高 RPM 限制。