CodeForLess CLI

Run Claude Code on your own machine, billed through your CodeForLess account.

Install

Requires Node ≥ 20. Works on macOS, Linux, and Windows.

npm install -g @codeforless/cli

Quick start

cfl login        # sign in (opens your browser; device-code flow)
cfl start        # start a session and launch Claude Code
# … work in Claude Code …
cfl stop         # end the session

Commands

Account

| Command | What it does | |---|---| | cfl login | Sign in via the CodeForLess device-code flow. Opens your browser to confirm a short code; the session is saved locally. | | cfl logout | Sign out, end any active session, and clear local credentials. | | cfl whoami | Show the signed-in account + credit balance. --json for machine-readable output. |

Sessions

| Command | What it does | |---|---| | cfl start | Start a session (debits 1 credit = 1 hour) and launch Claude Code in the foreground. Installs RTK first if missing. | | cfl status | Show the active session — state, credit balance, spend, request count. | | cfl extend | Extend the active session by +1 credit / +1 hour. | | cfl pause | Pause the active session (blocks the gateway, freezes the clock). Up to 2 pauses per session. | | cfl resume | Resume a paused session. | | cfl stop | End the active session. | | cfl exec <cmd> [args…] | Start a session and run a custom command instead of claude (e.g. a wrapper or another client). |

Options for start / exec:

| Flag | Meaning | |---|---| | --pack <id> | Bind the credit debit to a specific purchase/pack (UUID). | | --funding <personal\|org_pool> | Choose personal credits or an organization pool. | | -y, --yes | Install RTK without prompting if it's missing (for non-interactive shells / CI). |

cfl exec forwards everything after the command verbatim, so flags reach the wrapped program (put cfl's own flags before the command):

cfl exec claude -p "explain this repo" --model claude-haiku-4-5
cfl exec --yes claude --resume

RTK (token-saving proxy)

A session won't start until RTK + its Claude Code hook are installed — RTK rewrites common dev commands to cut 60–90% of token spend. The CLI sets this up for you on first start, or manage it directly:

| Command | What it does | |---|---| | cfl rtk status | Show whether the rtk binary + Claude Code hook are ready. --json for scripts. | | cfl rtk install | Install the rtk binary (~/.local/bin) and the PreToolUse:Bash hook. Idempotent. |

Help

cfl --help            # all commands
cfl <command> --help  # options for one command
cfl --version

Typical flow

cfl login
cfl rtk status                 # confirm the proxy is ready (start sets it up anyway)
cfl start                      # 1 credit → 1 hour, Claude Code launches
cfl status                     # check remaining balance / state mid-session
cfl extend                     # need more time? +1 credit / +1 hour
cfl pause                      # stepping away (freezes the clock)
cfl resume
cfl stop                       # done

Notes

• Credits: 1 credit = 1 hour. start and extend each debit 1; pause is free and freezes the clock.
• Run cfl status from any terminal — it finds the active session even if it was started elsewhere (or recovers it from the backend if the local handle is gone).

— codeforless.net