npm package: @joingonka/claude-code
Description: CLI installer for using Claude Code with JoinGonka Gateway (decentralized AI inference)
Author: JoinGonka
Latest version: 0.1.0

# @joingonka/claude-code

One-command installer that configures [Claude Code](https://docs.anthropic.com/en/docs/claude-code) to use the [JoinGonka Gateway](https://gate.joingonka.ai) — a decentralized AI inference gateway built on [Gonka](https://gonka.ai).

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

## Installation

Run the installer from any directory:

```bash
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.

```bash
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:

```json
{
  "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):

```json
{
  "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:

```json
{
  "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