常见问题

新手入门

刚开始使用？从这里开始：

• 欢迎使用 - 了解飞行API
• 注册并创建 Key - 创建账号并获取访问凭证
• 选择工具 - 找到适合你的AI助手

使用文档

详细的使用指南：

• 工具部署 - 各种AI工具的配置教程
• API文档 - 接口使用说明
• 定价说明 - 了解费用详情

常见问题

90%的问题都能在这里找到答案：

• 常见问题FAQ - 最常见的问题和解答
• 疑难杂症 - 技术问题排查指南

获取支持

需要人工帮助？

• 联系我们 - 多种联系方式
• QQ群组 - 实时在线交流
• 邮件支持 - 详细问题咨询

账号相关

• 如何注册账号？
• 忘记密码怎么办？
• 如何修改邮箱？

👉 查看常见问题 - 账号相关

API密钥

• 如何创建密钥？
• 密钥丢失了怎么办？
• 不同工具的密钥通用吗？

👉 查看常见问题 - API密钥相关

充值计费

• 支持哪些支付方式？
• 如何开发票？
• 可以退款吗？

👉 查看常见问题 - 充值相关

技术问题

• API密钥无效
• 连接超时
• 响应缓慢

👉 查看疑难杂症排查

Claude Code

• 部署指南
• 常见问题

CodeX

• 部署指南
• 常见问题

Gemini CLI

• 部署指南
• 常见问题

OpenCode

• 配置指南
• 常见问题

OpenClaw

• 部署指南
• 常见问题

1. 如何选择合适的模型？

根据任务类型选择：

• 简单任务：mini/haiku/flash
• 日常使用：标准版本
• 复杂任务：opus/GPTxhigh

详见定价说明

2. 如何节省成本？

• 选择合适的模型
• 控制输出长度
• 优化提示词
• 使用缓存

详见定价说明 - 节省成本

3. 连接失败怎么办？

检查：

• 网络连接
• API密钥
• API地址
• 账户余额

详见疑难杂症 - 网络问题

4. 响应质量不好？

改进方法：

• 使用更高级的模型
• 提供更多上下文
• 优化提示词

详见疑难杂症 - 响应问题

这页专门解决“连不上、超时、报错、工具启动异常”等问题。建议你按顺序排查，不要同时乱改一堆配置。

0. 先做三件事（最快定位问题）

• 确认你的 Key 没写错（不要多空格）
• 确认 Base URL 写对：
  OpenAI/Anthropic 兼容：https://ai.flyapi.top/v1
  少数工具不带 /v1：https://ai.flyapi.top
• 确认你的网络能访问目标地址

1. Claude Code 常见问题

1) 一直弹登录 / 走官方服务

先确认你已经设置了：

ANTHROPIC_BASE_URL=https://ai.flyapi.top
ANTHROPIC_AUTH_TOKEN=你的飞行API Key

验证方式：

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS/Linux：

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

如果变量是空的，说明根本没生效，回到对应系统教程重做一遍：

• /tools/claude-code/windows
• /tools/claude-code/macos
• /tools/claude-code/linux

2) 400 / 会话异常

通常是会话状态问题。你可以：

• 在工具里执行 /clear 清空会话重开
• 或者直接退出重启工具

2. Codex 常见问题

1) 配置写了但没生效

先确认配置文件存在：

• macOS/Linux：~/.codex/config.toml、~/.codex/auth.json
• Windows：%USERPROFILE%\.codex\config.toml、%USERPROFILE%\.codex\auth.json

再确认 base_url 是：

https://ai.flyapi.top/v1

以及 auth.json 里 Key 的字段名是 OPENAI_API_KEY。

3. Gemini CLI 常见问题

1) 安装后没有 gemini 命令

不同版本包名可能不同。你可以依次尝试：

npm install -g @google/generative-ai-cli
gemini --version

如果仍然没有，再试：

npm install -g @google/gemini-cli
gemini --version

2) 配了 Key 仍然提示登录

优先使用 .env 配置，并确认文件路径正确：

• Windows：%USERPROFILE%\.gemini\.env
• macOS/Linux：~/.gemini/.env

4. OpenCode 常见问题

1) 启动时报找不到 SDK

OpenCode 需要在配置目录安装 SDK，例如：

mkdir -p ~/.config/opencode
cd ~/.config/opencode
npm install @ai-sdk/anthropic

Windows 对应目录是：

cd $env:USERPROFILE\.config\opencode
npm install @ai-sdk/anthropic

2) 配置文件 JSON 格式错误

你可以用下面方式快速定位：

• 检查有没有漏逗号、漏引号
• 把文件复制到在线 JSON 校验工具里验证

5. OpenClaw 常见问题

1) doctor 提示 provider/api 配置不对

接入飞行API时，建议 api 用：

{ "api": "openai-responses" }

并把 baseUrl 指向：

https://ai.flyapi.top/v1

6. 仍然没解决？

请把下面信息准备好再联系支持，会快很多：

• 你用的工具名 + 版本（例如 claude --version）
• 你用的系统（Windows/macOS/Linux）和终端（PowerShell/zsh/bash）
• 你填的 Base URL（不要发 Key）
• 报错截图或完整报错文本

联系入口：

/help/support

视频教程

即将推出，敬请期待。

我们重视每一条反馈：

文档改进

发现文档错误或不清楚的地方？请告诉我们。

功能建议

有好的想法？我们很乐意听取。

Bug报告

发现问题？请详细描述以便我们修复。

👉 联系我们

• 快速响应用户问题
• 持续更新文档内容
• 不断改进产品服务
• 保护用户隐私安全

如果文档没有解决你的问题：

联系我们 我们随时为你服务！