常见问题（FAQ）

这页专门回答新手最常遇到的问题。如果你遇到的是“报错、超时、连不上”等技术问题，建议直接去看：

• 故障排除

账号与 API Key

1) API Key 在哪里创建？

请看教程：注册账号

2) 请求提示错误怎么办？

• 检查您在创建令牌的时候是否正确选择了分组（分组不能使用默认deafault，默认分组下无模型可用，需选择对应分组）
• 检查您的模型名字是否正确，可进入“模型广场”复制模型名字
• 检查您的API - Key是否正确复制并配置入配置文件
• 检查您的URL 是否已经替换为我们的API地址

3) 不同工具能不能共用同一个 Key？

如果要同时使用Codex + ClaudeCode，必须创建两个不同的分组，不同的分组对应不同的计费模式，对应不同的模型。

最好为一个工具创建一个分组，这样可以更好地管理不同的工具和模型。也能更好的进行计费管理。

充值与发票

1) 余额会过期吗？

不会，余额长期有效。

2) 如何开票？

累计消费满200元可申请开票，默认开普票，暂无手续费。专票需要联系客服协商，企业开票也需要联系客服确认。详细流程请看：

• 充值与发票

3) 可以退款吗？

可以，未使用余额可申请退款。

• 30天内退款无手续费
• 超过30天退款收取5%服务费
• 已消费部分、赠送金额、违规账户余额不退

环境与安装

1) 为什么总是提示我先装 Node.js？

因为很多 CLI 工具是 Node.js 写的，必须先有 Node 环境才能运行。

请按系统安装：

• Windows
• macOS
• Linux

2) npm 安装很慢/失败怎么办？

国内网络环境可以切换 npm 镜像（可随时改回）：

npm config set registry https://registry.npmmirror.com
npm config get registry

3) 环境变量设置了但不生效？

• Windows：设置用户级环境变量后，要重开终端窗口；仍不行就注销或重启
• macOS/Linux：写入 ~/.zshrc 或 ~/.bashrc 后，要 source 一次或重开终端

工具使用

1) 我是新手，先用哪个工具？

先从下面两个里选一个就够了：

• Claude Code
• Codex

2) Base URL 到底填哪个？

最常见的两个：

• https://api.ci-yuan-ai.com：少数工具要求不带 /v1（例如 Claude Code、Gemini CLI 常见写法）
• https://api.ci-yuan-ai.com/v1：OpenAI/Anthropic 兼容接口常用写法（Codex/OpenCode/OpenClaw 常见写法）

每个工具教程里我都写了“该填哪一个”，按工具页照抄即可。

仍然没解决？

1. 先看：故障排除
2. 再看：支持