Back to FAQ
Security

Is my API key stored safely?

Your API keys stay on your machine. claude-multi has no backend, no telemetry, and makes no network calls during normal operation.

Where keys end up

Each instance stores its key in ~/.claude-multi/<name>/settings.json as part of the ANTHROPIC_AUTH_TOKEN env var. When you launch that instance, Claude Code reads the key directly from the config file, claude-multi isn’t involved at runtime.

The only time claude-multi touches your key is during instance creation, when it writes it into the settings file. After that, it’s between you and Claude Code.

About those config writes

Settings files are written using a temp-file-rename pattern with JSON verification. The file gets written to a temp path, verified as valid JSON, then atomically renamed into place. No partial writes, no corrupted configs.

Practical tips

  • If you use the same key across providers, you can copy settings from ~/.claude during instance creation instead of re-entering it
  • For different keys per provider, enter them individually during setup or edit the settings file directly
  • Run claude-multi info <name> to see what’s stored for any instance
  • The version subcommand checks npm for updates, but that’s the only network call claude-multi ever makes, and it doesn’t involve your API key

More info