Hep.gg Documentation

ccas (Claude Code CLI)

A small CLI that routes Claude Code through the Hep.gg Claude proxy so your usage, machines, and projects are tracked, and syncs project context across devices.

ccas is a command-line tool that wires Claude Code through the Claude proxy. It registers your machine, manages the proxy_token for you, and (optionally) syncs project context so usage shows up in your AI dashboard across every device.

Install

Linux / macOS
bash -c "$(curl -fsSL https://ai.hep.gg/install)"

The installer downloads the CLI into a local bin directory, adds it to your PATH, and then runs ccas init. On Linux/macOS it installs to ~/.local/bin, or to /usr/local/bin when you run it with sudo / as root so the CLI is available system-wide; on Windows to %USERPROFILE%\.ccas\bin with a ccas.cmd wrapper. On macOS it will bootstrap Node automatically if it is missing.

The installer endpoints are public:

GEThttps://ai.hep.gg/installPublic
Bash installer for Linux/macOS.
GEThttps://ai.hep.gg/install.ps1Public
PowerShell installer for Windows.
GEThttps://ai.hep.gg/cliPublic
Raw CLI source the installers download.

Setup

ccas init

ccas init authenticates with your master token (from the dashboard, AI app), registers this machine, and picks a project to back. Once initialized, Claude Code traffic is routed through your Hep.gg proxy token so requests are metered and visible in the dashboard.

Sync

ccas sync

Pushes and pulls project context (the file manifest and tracked files) for the linked project, so the same context is available on your other machines. Sync state is keyed to your account; nothing is shared with other users.

If you rename or move a linked folder, a full ccas sync re-points it to the same synced project automatically, so renaming never creates a duplicate. To combine two projects that have already drifted apart, use ccas project merge.

Commands

CommandWhat it does
ccas initAuthenticate with your master token, register this machine, and pick a project to back.
ccas statusShow the configured server, machine, proxy token, proxy on/off state, and linked project.
ccas proxy [on|off]Toggle routing Claude Code through your Hep.gg proxy token (sets/clears ANTHROPIC_BASE_URL).
ccas link [path]Link a local directory to a synced project.
ccas syncPush + pull the linked project's tracked context.
ccas project [list|create|delete|merge]Manage your synced projects. merge <source> <target> combines the source project's files into the target, then removes the source.
ccas account ...Pool multiple Claude accounts, quick-swap, and autoswitch. See Multiple accounts.
ccas usage-token [new]Show/rotate the token for the Usage API.
ccas statusline [push|pull|install]Sync your ccstatusline status line across machines.
ccas cleanRemove local ccas state for the current machine.

Run ccas help for the full list.

See also