Comptes à clé d'API

Un compte à clé d'API lance Claude Code avec une clé d'API au lieu d'une connexion à un abonnement Claude : l'API d'Anthropic, ou un point de terminaison qui parle le même format Messages, comme une passerelle LiteLLM ou OpenRouter. ccam ne stocke pas la clé. Il la lit à chaque lancement du compte, depuis une variable d'environnement ou une commande comme un gestionnaire de mots de passe, et ne la transmet qu'à ce processus Claude Code.

Utilisation

ccam add api --api --key-from env:ANTHROPIC_KEY_WORK
ccam add gw --api --base-url https://llm.example.com --auth bearer \
  --model claude-sonnet-5-5 --key-from 'command:pass show llm/gateway-key'
ccam add mac --api --key-from 'command:security find-generic-password -s anthropic-api -w'
ccam gw -p "summarise the open issues"
ccam list

$ ccam list
   #  Name      Shortcut  Email                    Shared               Last used
*  1  personal  -         me@example.com           mcp settings md ext  2h ago
   2  gw        -         (API: llm.example.com)   mcp settings md ext  -

Un compte à clé d'API partage les paramètres, CLAUDE.md, les extensions et les serveurs MCP comme n'importe quel autre compte, et fonctionne avec les raccourcis, ccam folder et ccam ext.

Options

Les paramètres sont enregistrés dans config.toml :

[[profile]]
name = 'gw'
slot = 2

[profile.api]
base_url = 'https://llm.example.com'
key_from = 'command:pass show llm/gateway-key'
auth = 'bearer'
model = 'claude-sonnet-5-5'

Fonctionnement

À chaque lancement du compte, après les vérifications habituelles et avant le démarrage de Claude Code :

1. ccam lit la clé : env: depuis l'environnement, command: en exécutant la commande avec une limite de 30 secondes. Une commande peut demander un mot de passe dans le terminal ; sa sortie d'erreur va aussi au terminal. Une clé vide arrête le lancement avec un message qui indique où la clé était attendue.
2. Il retire toute variable héritée qui détermine comment Claude Code se connecte ou quel fournisseur il utilise : ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX et CLAUDE_CODE_USE_FOUNDRY. Une clé définie dans votre shell pour autre chose ne peut pas atteindre ce compte, et une connexion à un abonnement ne peut pas l'emporter sur sa clé.
3. Il définit ANTHROPIC_BASE_URL et ANTHROPIC_MODEL s'ils sont donnés, et la clé comme ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN.

Les comptes connectés à un abonnement gardent l'environnement dont ils héritent, comme avant. Dans une session interactive, Claude Code peut demander une fois s'il doit utiliser la clé qu'il trouve dans l'environnement.

Sécurité et cas particuliers

• La clé n'est jamais écrite dans config.toml, un cache ou un journal, et ccam --dry-run gw ne la lit pas : une source command: n'est pas exécutée par une simulation.
• ccam add --api vérifie une source env: tout de suite et avertit si la variable est vide ; une source command: est exécutée pour la première fois au lancement.
• ccam login et ccam logout refusent un compte à clé d'API, puisqu'il n'a pas de connexion. ccam doctor affiche son point de terminaison et la source de sa clé, et avertit quand une variable env: est vide.
• ccam usage affiche API pour lui. ccam next --auto, --fallback et ccam pick ne choisissent que parmi les comptes à abonnement, car une clé d'API n'a pas de limite sur 5 heures ou hebdomadaire à comparer.
• Un settings.json partagé avec un bloc env ou apiKeyHelper s'applique à chaque compte du groupe, comptes à clé d'API compris. Gardez les paramètres de fournisseur hors des paramètres partagés.

Voir aussi

• Gérer les comptes
• Lancer Claude Code
• Référence des commandes