多个工具共用预付余额
接入的工具从同一账户余额扣费，统一管理调用支出。
使用场景
写代码，做图片。一个账户接入。
把 Codex、Claude Code 和 Image Buddy 接入 Flatkey。继续使用熟悉的工具，共享预付余额，并在控制台查看每次调用的用量与费用。
调用用量与费用集中查看
逐次查看调用模型、Token 用量与费用，方便复盘花费。
API Key 与额度统一管理
在控制台管理 API Key、可用模型与调用额度。
使用场景 / 01—03
选好工具，按步骤接入。
01
适合任务Codex
读代码、修改文件、运行测试。
在代码仓库中使用 Codex 阅读代码、修改文件和迭代测试。将模型供应商配置指向 Flatkey，并使用 Flatkey API Key，后续调用从 Flatkey 余额扣费。
查看接入指南接入方式
- 兼容 OpenAI · config.toml
~/.codex/config.tomlbase_urlhttps://router.flatkey.ai/v1- API Key
FLATKEY_API_KEY
可以这样用
CLI 编码会话
把 Codex 提示、编辑和后续运行路由到同一个 Flatkey 余额。
自动修复循环
用 Codex 修 bug、跑测试迭代，同时每次请求都可计量。
02
适合任务Claude Code
功能开发、代码重构与排错。
继续在终端中使用 Claude Code 完成功能开发、重构和排错。通过兼容 Anthropic 的端点连接 Flatkey，在同一控制台查看调用用量与费用。
查看接入指南接入方式
- 兼容 Anthropic · settings.json
~/.claude/settings.jsonANTHROPIC_BASE_URLhttps://router.flatkey.ai- API Key
ANTHROPIC_AUTH_TOKEN
可以这样用
代码库探索
让 Claude Code 扫描、解释并梳理大型代码库，同时用量进入 Flatkey。
重构循环
以可见成本和预付余额控制运行更多编辑、测试、复审循环。
03
适合任务Image Buddy
商品主图、场景图与广告素材。
从命令行生成商品主图、商品白底图和 UGC 风格广告素材。安装 Image Buddy、初始化账户后，即可提交提示词。下方展示的是 Image Buddy 接入指南中的生成示例。
查看接入指南Image Buddy CLI · 安装并初始化
- 01安装
npm i -g @flatkey-ai/image-buddy - 02初始化
npx @flatkey-ai/image-buddy onboard - 03生成
npx @flatkey-ai/image-buddy generate --prompt "商品场景主图"
三步完成工具接入。
获取 key- 01
创建 Flatkey API Key
注册账户，在控制台创建一把 API Key。
- 02
按所选工具完成配置
按所选工具的指南配置；Image Buddy 安装后先初始化。
- 03
在控制台查看用量
发起一次简单请求，再核对模型、用量与费用。
常见问题
需要更换原来的工具吗？
Codex 和 Claude Code 继续使用原有 CLI，按指南调整连接配置。Image Buddy 是独立 CLI，需要单独安装。
调用费用如何记录？
通过 Flatkey 接入的调用从预付余额扣费，可在控制台查看模型价格与调用用量记录。
配置后怎么确认接入成功？
从配置好的工具发起一次简单请求，再到控制台确认对应模型与用量记录。
Codex 和 Claude Code 的配置一样吗？
不一样。Codex 使用兼容 OpenAI 的连接方式，Claude Code 使用兼容 Anthropic 的连接方式。两者的配置文件和参数名不同，请分别按对应工具的接入指南设置。
应该怎么选择模型？
先确认工具支持哪些模型，再查看 Flatkey 上的可用状态与价格。配置时使用指南或模型页中的完整模型 ID，先跑一个小任务，再用于较长的工作流程。
请求失败时先检查什么？
先核对端点地址、API Key、模型 ID 和可用余额，再根据报错对照接入指南排查。需要协助时可以提供报错信息与请求时间，请勿发送完整 API Key。
Image Buddy 可以生成哪些图片？
本页展示了商品场景主图、商品白底图和 UGC 风格广告素材。按 Image Buddy 指南完成初始化后，在提示词里描述商品、场景和图片用途即可开始尝试。
如何保护 API Key？
将 Key 保存在本地配置文件或环境变量中，不要放进公开仓库、浏览器端代码或截图。发生泄露时，在控制台禁用原 Key，并创建新的 Key 替换。