> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kloudlinq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> A Claude Code profile manager for isolated identities

**ccp** (Claude Code Profile Manager) lets you switch between fully isolated Claude Code identities — personal subscription, work Bedrock, a direct API key, an OpenRouter gateway — without leftover environment variables from one silently billing the other.

Claude Code resolves credentials by priority: cloud provider vars > `ANTHROPIC_AUTH_TOKEN` > `ANTHROPIC_API_KEY` > OAuth/subscription. If you juggle more than one identity by hand, a leftover variable from the previous context silently wins. ccp makes the switch atomic — every known routing variable is unset, then the target profile's set is applied.

## Two surfaces, one core

ccp ships two entry points that share a core library, so switching and creation logic never diverge:

* **Terminal CLI (`ccp`)** — with a zsh wrapper for real per-shell switching.
* **VS Code extension** — for the official Claude Code panel, with workspace pinning and a wrong-profile guardrail.

## Requirements

* **macOS.** Secrets live in the macOS Keychain via the `security` CLI. Cross-platform secret backends are on the roadmap.
* **zsh.** The shell wrapper (`shell/ccp-init.zsh`) uses zsh hooks. bash/fish ports are on the roadmap.
* **Node.js 18+** and npm.
* **Claude Code CLI** (`claude`) on your PATH for subscription login flows.

## Why ccp

<CardGroup cols={2}>
  <Card title="Isolated identities" icon="shield-halved">
    Each profile gets its own `CLAUDE_CONFIG_DIR`, isolating credentials, `settings.json`, MCP servers, `CLAUDE.md`, and session history.
  </Card>

  <Card title="Six auth types" icon="key">
    Subscription, API key, gateway (OpenRouter, Requesty, Z.AI, any Anthropic-compatible endpoint), Bedrock, Vertex, and Foundry.
  </Card>

  <Card title="Keychain-backed" icon="lock">
    API keys and gateway tokens live in the macOS Keychain under one service name. Cloud profiles store no local secret at all.
  </Card>

  <Card title="Atomic switching" icon="arrows-rotate">
    Every routing variable is unset before the new profile is applied — no cross-contamination between identities.
  </Card>
</CardGroup>

## What's next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/ccp/quickstart">
    Install ccp and create your first profile.
  </Card>

  <Card title="Profiles" icon="users" href="/ccp/profiles">
    Learn how profiles are structured, stored, and isolated.
  </Card>

  <Card title="Authentication" icon="key" href="/ccp/authentication">
    All six auth types and what each one materializes.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/ccp/cli">
    Every `ccp` command.
  </Card>
</CardGroup>