FlowAI Docs

文档说明

本文档适用于 flowai.boundesu.com 用户，主要用于说明如何完成 Codex / Claude API 的基础接入配置。

适用范围包括：

• Codex CLI
• Codex 客户端
• Codex 插件
• 其他兼容 OpenAI 风格接口的工具

前置准备：兑换额度

在正式配置 API 前，请先完成额度兑换。

1. 打开首页 flowai.boundesu.com
2. 点击【控制台】
3. 打开【钱包管理】
4. 输入兑换码，完成额度兑换

图片待补充：钱包管理与兑换码输入界面

第一步：获取密钥（Key）

1. 打开首页：https://flowai.boundesu.com
2. 登录或注册你的账号
3. 打开【令牌管理】
4. 点击【添加令牌】
5. 生成后保存你的 API Key

密钥格式一般类似：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

图片待补充：令牌管理页面

图片待补充：添加令牌弹窗或生成成功界面

第二步：配置文件设置（Mac / Windows 通用）

方法一：手动配置

2.1 创建或修改 config.toml

此文件用于配置模型和接口地址，修改后会永久生效。

Windows 默认路径：

%USERPROFILE%\.codex\config.toml

实际示例路径：

C:\Users\当前电脑用户名\.codex\config.toml

如果你的电脑里没有 .codex 文件夹：

• 可以手动新建
• 或者先运行一次 codex

配置如下：

model_provider = "flowai_codex"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.flowai_codex]
name = "flowai_codex"
base_url = "https://flowai.boundesu.com/v1"
wire_api = "responses"
requires_openai_auth = true

2.2 创建或修改 auth.json

此文件用于配置你的 API Key，修改后会永久生效。

Windows 默认路径：

%USERPROFILE%\.codex\auth.json

实际示例路径：

C:\Users\当前电脑用户名\.codex\auth.json

文件内容如下：

{
  "OPENAI_API_KEY": "替换为你自己的 API Key"
}

2.3 重启 Codex

每次修改配置文件后，都建议重启 Codex，以确保配置被重新加载。

迁移与辅助工具

如果你需要更换 API 项目，或迁移对话/配置，可使用下面的工具仓库：

codex-memory-migration-tool

可直接将仓库地址交给 AI 工具执行下载和迁移。

常见问题

1. 401 Unauthorized

原因：

• API Key 错误
• Key 为空

解决方法：

• 检查 OPENAI_API_KEY
• 确认没有输错字符

2. 404 Not Found

原因：

• 接口地址写错

解决方法：

• 确认填写的是：

https://flowai.boundesu.com/v1

3. 429 Too Many Requests

原因：

• 请求过于频繁
• 当前额度不足

解决方法：

• 等待冷却
• 联系续费

4. 网络错误 / 超时

原因：

• 当前网络环境不稳定
• 代理或 VPN 冲突

解决方法：

• 检查网络
• 切换更稳定线路
• 保证配置里没有多余空格

5. 无法正常输出流式内容

解决方法：

• 检查客户端是否支持当前接口方式
• 如果有模型切换项，优先使用推荐模型s