常见问题
汇总使用 云策平台及各 AI 工具配置过程中的常见问题与解决方案。
账号与计费
如何注册 云策账号？
前往 yuncezn.com/register，使用邮箱注册即可创建免费账号。
充值后余额会过期吗？
不会。云策的余额永不过期，1 RMB = 1 USD，按实际使用量计费。
支持哪些支付方式？
支持支付宝、微信支付。前往 yuncezn.com/purchase 进行充值。
如何查看用量明细？
登录控制台后，在「用量」或「日志」页面可查看请求时间、模型、输入/输出 token、调用次数等明细。
配置相关
Codex CLI 提示 command not found
npm 全局安装路径未加入系统 PATH。执行以下命令查看全局安装路径：
npm bin -g将该路径加入 PATH，或重启终端后重试。
Codex 配置写入后不生效
关键点
配置写入 ~/.codex 后，已打开的 Codex CLI 需要重启后才会读取新配置。Codex App 客户端同样会在下次启动时自动读取。
请退出当前 Codex 进程后重新启动。
Claude Code 报 401 unauthorized
排查清单：
- API Key 是否复制完整，无多余空格
ANTHROPIC_AUTH_TOKEN是否写错变量名- 配置文件是否保存到了正确路径
- shell 环境变量是否覆盖了配置文件（环境变量优先级更高）
Claude Code 的 ANTHROPIC_BASE_URL 要不要带 /v1？
不要。Claude Code 走 Anthropic 兼容协议，ANTHROPIC_BASE_URL 应设置为 https://yuncezn.com，不带 /v1 后缀。
Gemini CLI 报 404 model not found
排查清单：
OPENAI_BASE_URL是否带了/v1后缀（应为https://yuncezn.com/v1）- 模型名是否在控制台可用列表中
- Claude Code 与 Gemini CLI 走的协议不同，配置不能混用
OpenClaw 本地命令执行失败
检查 ~/.openclaw/config.json 中的 allowed_paths 是否限制了访问路径，或开启 confirm_before_execute 逐步确认。
网络与连通性
调用 API 偶尔超时
云策采用专线高速直连，若仍出现超时：
- 检查本地网络是否稳定
- 确认是否短时间内发送大量请求触发速率限制
- 在控制台查看请求日志，确认请求是否到达平台
本地有返回，但控制台没有日志
可能原因：
- 工具仍走旧配置（重启 CLI）
- shell 环境变量覆盖了配置文件
- 配置文件路径错误
建议先跑只读任务，再对照控制台日志时间、模型名、token 用量确认请求确实走了云策。
安全
API Key 泄露了怎么办？
立即登录控制台重置/删除泄露的 Key，并创建新的 Key。同时检查用量日志，确认是否有异常调用。
可以把 API Key 提交到 Git 仓库吗？
严禁。API Key 等同于账户凭证，请：
- 在
.gitignore中加入.codex/auth.json、.claude/、.openclaw/等配置目录 - 使用环境变量或密码管理器管理密钥
- 切勿硬编码至代码中
模型与功能
支持哪些模型？
支持 Claude 全系列、OpenAI GPT 全系列、Gemini 系列等主流模型，具体以控制台可用模型列表为准。
可以在不同工具间共享余额吗？
可以。同一个 云策账号下的 API Key 可在 Codex、Claude Code、Gemini CLI、OpenClaw 等工具间共用，余额统一结算。
如何切换使用的模型？
- Codex：在
~/.codex/config.toml中修改model字段 - Claude Code：在启动参数或配置文件中指定模型
- Gemini CLI：在
~/.gemini/settings.json中修改model字段
其他
文档内容与官网不一致怎么办？
本文档站为基于 VitePress 的复刻版本，若与 yuncezn.com/docs 官方文档存在差异，以官方文档为准。
如何反馈问题或建议？
请通过 yuncezn.com 官网联系客服或提交反馈。