AtomFlow 使用指南

从创建 API 令牌，到通过 CC Switch 接入 Claude Code、Codex 的中文实操教程。

AtomFlow 网站 · 官方文档 · 令牌管理 · CC Switch 下载

由 infranic 维护的社区指南。基于官方公开文档独立整理，不代表 AtomFlow 或 CC Switch 官方。界面、模型、分组和计费可能更新，请以控制台与官方文档为准。最近核对：2026-11-01。

你能在这里学到什么

• 登录 AtomFlow，检查账户额度并选择可用模型。
• 创建令牌（API Key），设置有效期、配额、模型限制和 IP 白名单。
• 从控制台一键导入 CC Switch，或手动配置 Claude Code、Codex。
• 验证配置是否生效，排查地址、令牌分组、模型和环境变量问题。

快速开始

1. 打开 AtomFlow，注册或登录，在钱包管理中确认账户有可用额度。
2. 进入 令牌管理，点击「添加令牌」。按目标工具选择对应分组，设置名称、有效期与配额，然后保存。
3. 从 CC Switch Releases 安装适合自己系统的版本。目标 CLI 也需要单独安装。
4. 在令牌所在行展开「聊天」旁的下拉菜单，选择「CC Switch」，选择 Claude、Codex 或 Gemini 配置类型，填写配置名称和主模型，再打开或导入到 CC Switch。
5. 在 CC Switch 中保存并启用配置，关闭并重新启动目标 CLI，发送一条简短测试消息。
6. 对照 AtomFlow 的使用日志，确认请求结果、模型与消耗。测试调用也可能产生费用。

完整步骤见 网站入门、令牌管理 和 CC Switch 接入。

手动配置速查

配置项	Claude Code	Codex
提供商名称（可自定义）	AtomFlow Claude	AtomFlow Codex
Base URL	https://api.atomflow.vip	https://api.atomflow.vip/v1
API Key	Claude Code 对应分组的令牌	Codex 对应分组的令牌
模型	控制台当前可用的 Claude 模型	控制台当前可用的 GPT 模型

注意地址末尾的 /v1 差异。 官方建议 Claude Code 与 Codex 使用不同令牌组。不要只替换模型名而沿用另一工具的分组。Gemini 的配置请按控制台导入结果及官方最新文档操作。

阅读目录

文档	内容
网站入门	账户、额度、模型、第一次调用与日志
令牌管理	创建、限制、复制、轮换与删除
CC Switch 接入	跨平台安装、一键导入、手动配置与切换
常见问题	认证、模型、额度、导入与环境变量排查
资料来源	官方链接、核对范围与维护约定
参与贡献	纠错与补充教程

令牌与费用

API Key 与账户额度相关。请只保存在可信客户端或私密配置中；提交 Issue、截图或配置文件前移除完整密钥。发生泄露后，在控制台禁用或删除旧令牌并创建新令牌。令牌「无限额度」仅表示令牌侧不封顶，仍受账户剩余额度限制。

本仓库不包含真实密钥，不要求上传密钥，也不执行充值或自动配置你的账户。具体模型价格与计费规则见控制台和 模型广场文档。

开源许可

本仓库原创教程采用 MIT License。AtomFlow、CC Switch 及其他第三方名称、商标和所链接内容属于各自权利人；链接内容遵循其各自许可。