v1.20Grok Build CLI support →

Profiles

Named bundles of (host CLI, endpoint, model, auth) — point Claude Code at Kimi, DeepSeek, Qwen, or any OpenAI-compatible endpoint without a local proxy.

What a profile does

A profile YAML lives under ~/.agents/profiles/. It says: use this binary, hit this endpoint, pick this model, read the API key from this Keychain item. When you run agents run kimi, the profile is resolved and its env block is injected into the child process. The YAML never holds a secret — it only stores the Keychain item name.

Built-in presets

All OpenRouter presets share a single key. Store it once and every preset picks it up:

agents profiles login openrouter        # prompts once, stored in Keychain
agents profiles add kimi                 # reasoning model — interactive use
agents profiles add kimi-chat            # non-reasoning sibling — safe for --print
agents profiles add deepseek             # non-reasoning DeepSeek Chat — safe for --print
agents profiles add qwen                 # Qwen3 coder — safe for --print
agents profiles presets                  # full catalog

Reasoning presets (kimi, minimax, glm) return empty output when run with --print. For scripted pipelines use the print-safe variants: kimi-chat, deepseek, qwen.

Run a profile

agents run kimi "refactor the auth handler"
agents run deepseek --print "summarize the diff"

The profile name replaces the agent argument. Everything else — flags, prompts, secrets — works identically to a normal agents run call.

Custom profiles

Any OpenAI-compatible endpoint works. Drop a YAML under ~/.agents/profiles/local-llama.yml:

name: local-llama
description: Local Llama 3.3 via Ollama
host:
  agent: claude
env:
  ANTHROPIC_BASE_URL: http://localhost:11434
  ANTHROPIC_MODEL: llama-3.3-70b
auth:
  envVar: ANTHROPIC_AUTH_TOKEN
  keychainItem: agents-cli.ollama.token

Then store the key and run:

agents profiles login ollama
agents profiles view local-llama
agents run local-llama "hello"

Inspect and rotate

agents profiles list                    # table: NAME HOST PROVIDER MODEL
agents profiles view kimi               # env vars, auth status, preset link
agents profiles login openrouter        # rotate key — all openrouter profiles pick it up
agents profiles remove kimi             # delete YAML; Keychain token is preserved
agents profiles logout openrouter       # also remove the Keychain token

Secrets

API keys are stored in macOS Keychain, never on disk. See secrets for the full credential model. Profiles are a narrower pattern: the YAML records which Keychain item to read; the profiles login command writes the value.

This page is about endpoint and model bundles. For rotating between multiple Claude accounts to avoid rate limits, see account rotation.

Related