# FlopCode

> This platform's official Claude Code fork — zero configuration, with 20+ models across the Claude, GPT and GLM families built in

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

> [FlopCode](https://www.npmjs.com/package/flopcode) is the Claude Code fork maintained by this platform — it targets this gateway by default with **no manual configuration**, and ships a picker covering 20+ models across the Claude, GPT and GLM families.

## Install

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

Run it:

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

The first launch walks you through signing in to (or creating) a platform account.

## How it differs from Claude Code

| | Claude Code | FlopCode |
|---|---|---|
| Default API | api.anthropic.com | zhonkeapi.dflop.top |
| Auth | Anthropic OAuth | platform CLI token (`gpshare_cli_*`) |
| Config directory | `~/.claude/` | `~/.flopcode/` |
| Model choice | the Claude line | **20+ models across Claude, GPT and GLM** |
| Billing | Anthropic subscription / API | subscription-tier token quota (below) |
| Remote control | ❌ | ✅ (drive it from your phone) |

## Switching model

Type `/model` in the REPL:

```
> /model

? Pick a model
  - claude-haiku-4-5-20251001   ★ (the first entry is the default)
  - claude-opus-4-6
  - claude-sonnet-4-6
  - gpt-5.5
  - glm-4.7
  - glm-5.1
  ...
```

Switching is instant — no env vars, no restart. Two things to know:

- The menu only lists the `claude-`, `gpt-` and `glm-` families (about 22 models today). `gemini-*`, `grok-*`, `kimi-*`, `deepseek-*` and others are **not** in the FlopCode menu and can't be reached by typing the id either — to use those, call the [API](../reference/api-reference.md) directly with an API key or use another client (full catalog: [Models](../reference/models.md)).
- The menu you actually see is further narrowed by your **subscription tier's model allowlist** (next section), and the default model is whatever sits first.

## Quota and billing

Once signed in, FlopCode uses a `gpshare_cli_*` CLI token and bills against your **subscription tier's token quota**. That is a **completely separate system** from the account balance (USD wallet) used by API keys (`sk-gpushare-*`):

| Tier | Daily tokens | Monthly tokens | Model allowlist |
|---|---|---|---|
| Free | 50K | 1.5M | the Claude Sonnet / Haiku tiers |
| Pro | 500K | 15M | adds the Claude Opus tier |

- Exceeding the daily quota returns **HTTP 429** `rate_limit_error` with a message like `Daily token quota exceeded (50123/50000). Resets at midnight UTC.` — the quota **resets automatically at midnight UTC**; upgrade the tier if you can't wait.
- Calling a model outside your tier's allowlist is rejected outright (HTTP 400, model not allowed).
- An `sk-gpushare-*` API key **cannot** be used to sign in to FlopCode, and topping up your account balance **will not** clear a FlopCode 429 — FlopCode usage doesn't draw on the balance, and API calls don't consume the token quota.
- Usage is visible at [zhonkemodel.dflop.top/dashboard/usage](https://zhonkezhonkemodel.dflop.top/dashboard/usage).

## Automatic updates

On launch it blocks briefly to check npm, and if there's a new version it runs `npm install -g flopcode` and restarts. To skip:

```bash
FLOPCODE_NO_UPDATE=1 flopcode
```

## Remote control (from your phone)

Run `/remote-control` or `/rc` in the REPL:

```
> /rc
[remote control enabled]
URL: https://dflop.top/remote/abc123
[QR code shown]

Scan it with your phone to drive this terminal remotely.
```

## Plugin marketplace

FlopCode supports git-based plugin marketplaces, managed with the `/plugin` command (note: **singular**). You must register a marketplace before installing, and plugin IDs always take the form `<plugin>@<marketplace>`:

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

The official marketplace (`gpushare-plugins`) currently contains:

- `clone-website` — provides the `/clone-website` skill

To publish your own: this is **not** `npm publish` followed by installing by package name. Create a git repository containing `.claude-plugin/marketplace.json` (or send a PR to an existing marketplace); users then register it with `/plugin marketplace add <owner>/<repo>` and install with `/plugin install <name>@<marketplace>`.

## Config files

`~/.flopcode/credentials.json` holds the login credentials. FlopCode and Claude Code never read each other's config directories (`~/.flopcode/` vs `~/.claude/`), so both CLIs can coexist.

## FlopCode or plain Claude Code?

If you only want Claude models and don't need this platform's multi-model picker, remote control or plugins, **plain Claude Code is fine** — [setting ANTHROPIC_BASE_URL](./claude-code.md) routes it through this gateway just as well.

FlopCode suits you if you want to:
- switch quickly between Claude, GPT and GLM
- pick up a coding session remotely from your phone
- use community plugins, or publish your own

## Troubleshooting

| Symptom | What to check |
|---|---|
| `flopcode --version` errors | Reinstall: `npm install -g flopcode` |
| Startup hangs on the update check | Skip it with `FLOPCODE_NO_UPDATE=1 flopcode` |
| 401, session expired | Re-authenticate with `/login` in the REPL |
| 429 `Daily token quota exceeded` | Your tier's daily token quota is spent; it resets at midnight UTC, or upgrade to Pro. Topping up an `sk-gpushare-*` key or the account balance **does nothing here** (separate systems — see "Quota and billing" above) |
| A model reports "model not allowed" | It isn't in your subscription tier's allowlist; pick one from the menu or upgrade |

## Source

FlopCode is distributed as an npm package: [npmjs.com/package/flopcode](https://www.npmjs.com/package/flopcode) (the repository isn't open source yet).

## Other clients

- [Claude Code](./claude-code.md) — Anthropic's official CLI
- [Cursor](./cursor.md) — AI built into the IDE
- [Cline (VS Code)](./cline.md) — agentic AI coding
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [Open WebUI](./open-webui.md) — self-hosted ChatGPT UI