重要提示： API key 仅允许在 Claude Code 和 CodeX 使用，禁止用于其他用途和二次分发。违规使用将导致账号被永久封禁。

Flapcode CLI 使用文档（Claude + Codex）

新版文档使用统一的 Flapcode CLI 流程，不再区分 Claude 与 Codex 两套安装文档。

下载

步骤 1：下载并全局安装 Flapcode CLI。

npm install -g @flapcode/cli

查看状态

步骤 4：查看当前状态。

flapcode status

如果当前账号在订阅中已失效（到期或被移除），状态中会显示 账号状态：✗ 已失效，此时运行 flapcode refresh 即可恢复到可用账号。

查看账号

查看账号列表。

flapcode accounts

可选：仅查看 Claude 账号。

flapcode accounts --provider claude

可选：仅查看 Codex 账号。

flapcode accounts --provider codex

切换账号

切换 Claude 账号（交互方式）。

flapcode claude use

可选：按序号直接切换 Claude 账号。

flapcode claude use 1

切换 Codex 账号（交互方式）。

flapcode codex use

可选：按序号直接切换 Codex 账号。

flapcode codex use 1

刷新配置

当订阅发生变化（例如续费后令牌更新、账号到期被移除或新增账号）后，无需重新选择账号，使用 flapcode refresh 即可重新拉取当前账号的服务端配置并改写本地文件。若本地记录的当前账号已失效，会自动切换到可用账号。

flapcode refresh

可选：仅刷新 Claude 配置。

flapcode refresh --provider claude

可选：仅刷新 Codex 配置。

flapcode refresh --provider codex

其他命令

更新 CLI 到最新版本。

flapcode update

查看 CLI 当前版本号。

flapcode -v

查看帮助信息（所有可用命令与参数）。

flapcode -h

在 Claude Code 升级后重新打补丁。

flapcode claude patch

退出登录。

flapcode logout

启动客户端

配置完成后，启动客户端。

启动 Claude Code。

claude

启动 Codex。

codex

Codex 手动配置

如果不使用 Flapcode CLI 自动生成配置，可以手动创建 ~/.codex/config.toml，默认模型使用 gpt-5.5。

model = "gpt-5.5"
model_provider = "flapcode"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.flapcode]
name = "flapcode"
base_url = "https://codex.flapcode.com/v1"
wire_api = "responses"

同时创建 ~/.codex/auth.json，填入你的 API Key。

{
  "OPENAI_API_KEY": "sk-flapcode-xxx"
}

Flapcode CLI 使用文档