# FlopCode 集成

> 本平台官方 Claude Code fork, 零配置开箱即用, 内置 Claude / GPT / GLM 三大家族 20+ 模型

来源：https://zhonkemodel.dflop.top/docs/integrations/flopcode

> [FlopCode](https://www.npmjs.com/package/flopcode) 是本平台官方维护的 Claude Code fork —— 默认走本网关,**无需任何手动配置**,内置 Claude / GPT / GLM 三大家族 20+ 模型的选择器。

## 安装

```bash
npm install -g flopcode
```

启动:

```bash
cd your-project
flopcode
```

首次启动会引导你登录 / 注册本平台账户。

## 跟 Claude Code 的区别

| 项 | Claude Code | FlopCode |
|---|---|---|
| 默认 API | api.anthropic.com | zhonkeapi.dflop.top |
| 鉴权 | Anthropic OAuth | 平台 CLI Token (`gpshare_cli_*`) |
| 配置目录 | `~/.claude/` | `~/.flopcode/` |
| 模型选择 | Claude 系列 | **Claude / GPT / GLM 三族 20+ 模型** |
| 计费 | Anthropic 订阅 / API | 平台订阅档位 token 配额(见下) |
| Remote Control | ❌ | ✅ (手机远程操控) |

## 切换模型

REPL 内输入 `/model`:

```
> /model

? Pick a model
  - claude-haiku-4-5-20251001   ★ (菜单第一项即默认)
  - claude-opus-4-6
  - claude-sonnet-4-6
  - gpt-5.5
  - glm-4.7
  - glm-5.1
  ...
```

无需配 env / 重启,即时切换。两点说明:

- 菜单只收录 `claude-` / `gpt-` / `glm-` 三个家族的模型(当前 25 个)。`gemini-*`、`grok-*`、`kimi-*`、`deepseek-*` 等**不在** FlopCode 菜单中,手输 id 也无法调用 —— 要用这些模型,请用 API Key 直连 [API](../reference/api-reference.md) 或换其他客户端(完整目录见[模型列表](../reference/models.md))。
- 实际可见的菜单还会按你的**订阅档位模型白名单**收敛(见下节),默认模型即菜单第一项。

## 配额与计费

FlopCode 登录后使用 `gpshare_cli_*` CLI Token,计费走**订阅档位的 token 配额**;它与 API Key (`sk-gpushare-*`) 的账户余额(美元钱包)是**两套互不相通的体系**:

| 档位 | 每日 token | 每月 token | 模型白名单 |
|---|---|---|---|
| Free | 50K | 1.5M | Claude Sonnet / Haiku 档位 |
| Pro | 500K | 15M | 增加 Claude Opus 档位 |

- 超出每日配额返回 **HTTP 429** `rate_limit_error`,message 形如 `Daily token quota exceeded (50123/50000). Resets at midnight UTC.` —— 配额**每日午夜 (UTC) 自动重置**,等不及就升级档位。
- 调用不在档位白名单内的模型会直接被拒(HTTP 400, model not allowed)。
- `sk-gpushare-*` API Key **不能**用于 FlopCode 登录;给账户余额充值也**不会**解除 FlopCode 的 429 —— FlopCode 用量不扣余额,API 调用也不占 token 配额。
- 用量可在 [zhonkemodel.dflop.top/dashboard/usage](https://zhonkezhonkemodel.dflop.top/dashboard/usage) 查看。

## 自动更新

启动时阻塞检查 npm,如有新版本自动 `npm install -g flopcode` 并重启。跳过:

```bash
FLOPCODE_NO_UPDATE=1 flopcode
```

## Remote Control (手机操控)

REPL 内 `/remote-control` 或 `/rc`:

```
> /rc
[启用 Remote Control]
URL: https://dflop.top/remote/abc123
[QR Code 显示]

手机扫码后即可远程操控本终端。
```

## Plugin Marketplace

FlopCode 支持 git-based 插件 marketplace。REPL 内用 `/plugin` 命令管理(注意是**单数**),安装前必须先注册 marketplace,插件 ID 格式固定为 `<plugin>@<marketplace>`:

```
> /plugin marketplace add sharegpu/gpushare-plugins
> /plugin install clone-website@gpushare-plugins
```

官方 marketplace (`gpushare-plugins`) 当前含:

- `clone-website` — 提供 `/clone-website` skill

发布自己的插件:**不是** `npm publish` 后凭包名安装 —— 建一个含 `.claude-plugin/marketplace.json` 的 git 仓库(或向现有 marketplace 提 PR),用户先 `/plugin marketplace add <owner>/<repo>` 注册,再 `/plugin install <name>@<marketplace>` 安装。

## 配置文件

`~/.flopcode/credentials.json` 存登录凭证。FlopCode 与 Claude Code 的配置目录(`~/.flopcode/` vs `~/.claude/`)互不读取 —— 两个 CLI 可以共存。

## 跟普通 Claude Code 比较

如果你只想用 Claude 模型 + 不需要本平台多模型 / Remote Control / Plugins,**继续用 Claude Code 也行** —— [设置 ANTHROPIC_BASE_URL](./claude-code.md) 一样可以走本网关。

FlopCode 适合:
- 需要快速在 Claude / GPT / GLM 间切换
- 要远程从手机继续上一个 coding session
- 想用社区插件 / 自己发插件

## 常见问题

| 现象 | 排查 |
|---|---|
| `flopcode --version` 报错 | 重装: `npm install -g flopcode` |
| 启动卡在更新检查 | `FLOPCODE_NO_UPDATE=1 flopcode` 跳过 |
| 401 登录失效 | REPL 内 `/login` 重新认证 |
| 429 `Daily token quota exceeded` | 订阅档位每日 token 配额用尽,午夜 (UTC) 重置或升级 Pro。给 `sk-gpushare-*` Key / 账户余额充值**无效**(两套体系,见上方「配额与计费」) |
| 模型报 model not allowed | 该模型不在订阅档位白名单内,换菜单内模型或升级档位 |

## 源码

FlopCode 以 npm 包形式分发: [npmjs.com/package/flopcode](https://www.npmjs.com/package/flopcode)(仓库暂未开源)。

## 其他客户端

- [Claude Code](./claude-code.md) — Anthropic 官方 CLI
- [Cursor](./cursor.md) — IDE 内置 AI
- [Cline (VS Code)](./cline.md) — agentic AI Coding
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [Open WebUI](./open-webui.md) — 自托管 ChatGPT 界面