@joingonka/claude-code

One-command installer that configures Claude Code to use the JoinGonka Gateway — a decentralized AI inference gateway built on Gonka.

Pay in USD, USDT, or crypto. No Anthropic account required.

Installation

Run the installer from any directory:

npx @joingonka/claude-code

The CLI will interactively ask for your API key — the key from your JoinGonka dashboard, starting with jg-. By default it writes to user scope (~/.claude/settings.json); pass --scope local to write the project-scoped file instead.

npx @joingonka/claude-code              # user scope (global)
npx @joingonka/claude-code --scope local # project-scoped

After the installer finishes, run claude in a new terminal and it will route through the JoinGonka Gateway.

What it does

The installer writes two environment variables into your Claude Code settings file:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "jg-...",
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai"
  }
}

• user scope writes to ~/.claude/settings.json
• local scope writes to ./.claude/settings.local.json

All other fields in the file (themes, hooks, permissions, custom env vars) are preserved untouched. A timestamped backup (settings.json.bak.YYYYMMDDHHMMSS) is created before any existing file is overwritten, and the write itself is atomic — the file is never left half-written.

Security notes

• API keys are only accepted via interactive prompt. The installer deliberately does NOT support an --api-key flag. Passing secrets on the command line leaks them into shell history, ps aux, and any logs that capture process arguments.
• The key is written to disk inside your settings file. Treat that file as a secret (it already contains other secrets used by Claude Code).
• The gateway base URL is hardcoded to https://gate.joingonka.ai and cannot be overridden. This is intentional: the entire purpose of this installer is the one-command redirect to our managed gateway.

Manual setup alternative

If you prefer not to use the installer, add the following to ~/.claude/settings.json (user scope) or .claude/settings.local.json (local scope):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key-here",
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai"
  }
}

Preserve any existing fields in the file.

Uninstall

Remove the two keys from your settings file:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "...",   // remove
    "ANTHROPIC_BASE_URL": "..."      // remove
  }
}

Claude Code will fall back to the default Anthropic API (and prompt you to log in again).

Flags reference

Usage: joingonka-claude-code [options]

Options:
  -V, --version      output the version number
  --scope <scope>    installation scope: "user" (global) or "local" (project),
                     defaults to "user"
  -h, --help         display help for command

Links

• Gateway: https://gate.joingonka.ai
• JoinGonka: https://joingonka.ai
• Gonka network: https://gonka.ai
• Issues: https://github.com/unameisfine/joingonka-claude-code/issues

License

Apache-2.0