FlopCode 集成
本平台官方 Claude Code fork, 零配置开箱即用, 内置 Claude / GPT / GLM 三大家族 20+ 模型
FlopCode 是本平台官方维护的 Claude Code fork —— 默认走本网关,无需任何手动配置,内置 Claude / GPT / GLM 三大家族 20+ 模型的选择器。
安装#
npm install -g flopcode
启动:
cd your-project
flopcode
首次启动会引导你登录 / 注册本平台账户。
跟 Claude Code 的区别#
| 项 | Claude Code | FlopCode |
|---|---|---|
| 默认 API | api.anthropic.com | api.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.4
- gpt-5.5
- glm-4.7
- glm-5.1
...
无需配 env / 重启,即时切换。两点说明:
- 菜单只收录
claude-/gpt-/glm-三个家族的模型(当前约 22 个)。gemini-*、grok-*、kimi-*、deepseek-*等不在 FlopCode 菜单中,手输 id 也无法调用 —— 要用这些模型,请用 API Key 直连 API 或换其他客户端(完整目录见模型列表)。 - 实际可见的菜单还会按你的订阅档位模型白名单收敛(见下节),默认模型即菜单第一项。
配额与计费#
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 配额。- 档位详情见 FlopCode 订阅档位,用量可在 model.dflop.top/dashboard/usage 查看。
自动更新#
启动时阻塞检查 npm,如有新版本自动 npm install -g flopcode 并重启。跳过:
FLOPCODE_NO_UPDATE=1 flopcode
Remote Control (手机操控)#
REPL 内 /remote-control 或 /rc:
> /rc
[启用 Remote Control]
URL: https://dflop.top/remote/abc123
[QR Code 显示]
手机扫码后即可远程操控本终端。
详见 FlopCode 命令文档。
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-websiteskill
发布自己的插件:不是 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 一样可以走本网关。
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(仓库暂未开源)。
其他客户端#
- Claude Code — Anthropic 官方 CLI
- Cursor — IDE 内置 AI
- Cline (VS Code) — agentic AI Coding
- Continue.dev — VS Code / JetBrains
- Open WebUI — 自托管 ChatGPT 界面