# Claude Code > Connect Claude Code to Passion8. Install the CLI, desktop app, and official IDE extensions on macOS or Windows, then configure Passion8 manually or with CC-Switch. URL: https://docs.passion8.cc/en/docs/claude-code Language: en Publisher: Passion8 Claude Code is Anthropic's agentic coding tool for terminals, IDEs, desktop, and web. Connecting it to Passion8 routes its Anthropic-compatible requests to `https://passion8.cc`. Claude Code uses `https://passion8.cc` as its Base URL, without `/v1`. Codex and OpenAI-compatible clients use `https://passion8.cc/v1`. ## Connection steps Install first, then configure. Choose either manual configuration or CC-Switch with explicit Passion8 settings. - [Installation](https://docs.passion8.cc/en/docs/claude-code/install): Install the CLI, desktop app, and official IDE extensions on macOS or Windows. - [Configuration](https://docs.passion8.cc/en/docs/claude-code/settings): Connect to Passion8 manually or with CC-Switch. The Base URL has no /v1 suffix. ## Learning and workflows After connecting successfully, learn how Claude Code works, its command system, and team workflows. - [How it works and extension map](https://docs.passion8.cc/en/docs/claude-code/how-it-works): The agentic loop, models, tools, context loading, extensions, and cache costs. - [Official coverage map](https://docs.passion8.cc/en/docs/claude-code/official-coverage-map): An audit of 163 official Markdown pages, 101 slash commands, and local Chinese documentation entry points. - [Command reference](https://docs.passion8.cc/en/docs/claude-code/commands): CLI flags, slash commands, background agents, reviews, shortcuts, and permission modes. - [Commands and cache effects](https://docs.passion8.cc/en/docs/claude-code/command-cache): Command-by-command effects on 5-minute/1-hour TTL, models, effort, fast mode, MCP, and background agents. - [Interactive mode and terminal experience](https://docs.passion8.cc/en/docs/claude-code/interactive-terminal): Keyboard shortcuts, Vim mode, shell mode, background Bash, tmux, fullscreen, voice input, and caching. - [CLI and terminal reference](https://docs.passion8.cc/en/docs/claude-code/cli-terminal-reference): CLI commands, installation channels, environment variables, PATH, terminal shortcuts, fullscreen, voice, and deep links. - [Best practices and workflows](https://docs.passion8.cc/en/docs/claude-code/best-practices-workflows): Connect exploration, planning, implementation, verification, review, subagents, and headless scripts into executable workflows. - [Prompt library and team adoption](https://docs.passion8.cc/en/docs/claude-code/prompt-library): Reusable prompts for exploration, implementation, debugging, review, releases, champions, and rollouts. ## Context and sessions - [Models, effort, and fast mode](https://docs.passion8.cc/en/docs/claude-code/model-fast-mode): /model, /effort, opusplan, fallback, Advisor, 1M context, and fast mode. - [Feature availability and provider differences](https://docs.passion8.cc/en/docs/claude-code/feature-availability): Capability boundaries for Claude subscriptions, Anthropic API, Passion8, and third-party providers. - [Memory and rules](https://docs.passion8.cc/en/docs/claude-code/memory): CLAUDE.md, auto memory, .claude/rules, and AGENTS.md compatibility. - [Output styles](https://docs.passion8.cc/en/docs/claude-code/output-styles): Default, Proactive, Explanatory, Learning, custom output-styles, and cache effects. - [Context window](https://docs.passion8.cc/en/docs/claude-code/context): /context, file reads, rules, hooks, compact, and context usage control. - [Large codebases and monorepos](https://docs.passion8.cc/en/docs/claude-code/large-codebases): Startup directories, layered CLAUDE.md, Read deny, sparse worktrees, cross-package access, and directory-level skills. - [Session management](https://docs.passion8.cc/en/docs/claude-code/sessions): Boundaries of resume, branch, rename, transcripts, /cd, /clear, and /compact. - [Checkpoints and rewind](https://docs.passion8.cc/en/docs/claude-code/checkpointing): /rewind, restoring checkpoints, restoring only code or conversation, and boundaries with Git. ## Security and governance - [Permissions and modes](https://docs.passion8.cc/en/docs/claude-code/permissions): allow/ask/deny and default/plan/auto/dontAsk/bypassPermissions rules. - [Auto mode policy reference](https://docs.passion8.cc/en/docs/claude-code/auto-mode-policy): Trusted infrastructure, allow/soft_deny/hard_deny, classifyAllShell, and denial reviews. - [Sandboxing and isolated environments](https://docs.passion8.cc/en/docs/claude-code/sandboxing): Bash sandboxing, Sandbox runtime, Dev Containers, Docker, VMs, network, and credential boundaries. - [Sandbox and Dev Containers](https://docs.passion8.cc/en/docs/claude-code/sandbox-devcontainers): Compare sandboxes, Dev Containers, custom containers, VMs, credential protection, and cache boundaries. - [Enterprise deployment overview](https://docs.passion8.cc/en/docs/claude-code/enterprise-deployment-overview): Plan organization deployment by provider, authentication, managed settings, permissions, monitoring, and data boundaries. - [Enterprise networking and administration](https://docs.passion8.cc/en/docs/claude-code/enterprise-admin): Proxies, CAs, mTLS, server-managed settings, endpoint-managed settings, and managed MCP. - [Enterprise controls and managed settings](https://docs.passion8.cc/en/docs/claude-code/enterprise-controls): Server-managed settings, endpoint-managed settings, managed MCP, auto mode, analytics, and compliance checklists. - [Enterprise rollout](https://docs.passion8.cc/en/docs/claude-code/enterprise-rollout): Roll out providers, gateways, settings, MCP, observability, auto mode, and training in stages. - [Adoption and communications kit](https://docs.passion8.cc/en/docs/claude-code/adoption-communications): Champions, launch announcements, drip campaigns, FAQs, pilot feedback, and Passion8 messaging. - [Data usage and privacy](https://docs.passion8.cc/en/docs/claude-code/data-usage): Training policies, retention, local plaintext transcripts, telemetry, WebFetch, and Passion8 gateway boundaries. - [Zero Data Retention](https://docs.passion8.cc/en/docs/claude-code/zero-data-retention): ZDR coverage, disabled features, local transcripts, gateway logs, and caching misconceptions. - [Security](https://docs.passion8.cc/en/docs/security): API keys, permissions, hooks, MCP, and gateway security essentials. ## Extensions and automation - [Tool reference](https://docs.passion8.cc/en/docs/claude-code/tools): Read/Edit/Bash/Grep/Agent/Monitor tools, permission rules, and hook matchers. - [Subagents](https://docs.passion8.cc/en/docs/claude-code/subagents): Built-in Explore/Plan/general-purpose, custom agents, permissions, models, and context isolation. - [Parallel agents, background work, and workflows](https://docs.passion8.cc/en/docs/claude-code/parallel-agents): Agent View, /background, /batch, /fork, /goal, /loop, and dynamic workflows. - [Advanced workflows and cloud collaboration](https://docs.passion8.cc/en/docs/claude-code/advanced-workflows-cloud): Choosing Advisor, Agent View, /goal, dynamic workflows, Routines, Ultraplan, and Ultrareview. - [Agent Teams and channels](https://docs.passion8.cc/en/docs/claude-code/agent-teams-channels): Collaboration across Claude sessions, external events, permission relay, and channel MCP boundaries. - [Routines and /loop scheduling](https://docs.passion8.cc/en/docs/claude-code/routines-scheduling): Local loops, Cron, cloud routines, /schedule, API/GitHub triggers, and TTL strategies. - [Parallel workspaces with worktrees](https://docs.passion8.cc/en/docs/claude-code/worktrees): --worktree, PR worktrees, .worktreeinclude, cleanup strategies, and subagent isolation. - [Connecting MCP tools](https://docs.passion8.cc/en/docs/claude-code/mcp): HTTP, SSE, stdio, WebSocket, OAuth, scopes, tool search, and gateway considerations. - [Gateways and protocols](https://docs.passion8.cc/en/docs/claude-code/gateway): Passion8 Base URL, header/body forwarding, model discovery, cache fields, and common 400/401 errors. - [Gateway protocol launch checklist](https://docs.passion8.cc/en/docs/claude-code/gateway-protocol): Protocol formats, headers/body, attribution, model discovery, spend limits, error semantics, and cache acceptance checks. - [Gateway operations](https://docs.passion8.cc/en/docs/claude-code/gateway-operations): Claude apps gateway, common protocols, OIDC, Postgres, spend limits, model discovery, and cache forwarding. - [Deploying Claude apps gateway](https://docs.passion8.cc/en/docs/claude-code/gateway-cloud-deployment): Private ingress, OIDC, Kubernetes, Cloud Run, GCP, Postgres, health checks, and upgrades. - [Hook automation](https://docs.passion8.cc/en/docs/claude-code/hooks): Lifecycle automation with PreToolUse, PostToolUse, ConfigChange, FileChanged, and more. - [Plugins and skills](https://docs.passion8.cc/en/docs/claude-code/plugins): Plugin manifests, skills, agents, hooks, MCP, LSP, and marketplace distribution. - [Plugin marketplaces and distribution](https://docs.passion8.cc/en/docs/claude-code/plugin-marketplaces): Official, community, and internal marketplaces, version constraints, recommendation rules, and security plugins. - [Status line](https://docs.passion8.cc/en/docs/claude-code/statusline): /statusline, context usage, cost, Git, PRs, rate limits, and local script performance. - [Headless automation](https://docs.passion8.cc/en/docs/claude-code/headless): claude -p, --bare, JSON/stream-json, CI scripts, structured output, and background waiting. - [Agent SDK](https://docs.passion8.cc/en/docs/claude-code/sdk): Embed the Claude Code agent loop into TypeScript/Python products. - [Agent SDK API reference](https://docs.passion8.cc/en/docs/claude-code/sdk-api-reference): TypeScript/Python installation, query, ClaudeSDKClient, tool helpers, session APIs, settings resolution, and migration. - [Agent SDK agent features](https://docs.passion8.cc/en/docs/claude-code/sdk-agent-features): Agent loop, settingSources, sessions, skills, subagents, TODO tracking, checkpointing, and hosting limits. - [Agent SDK capability matrix](https://docs.passion8.cc/en/docs/claude-code/sdk-capabilities): Permission evaluation, hooks, MCP, SessionStore, cost tracking, OTEL, secure deployment, and caching. - [Agent SDK runtime patterns](https://docs.passion8.cc/en/docs/claude-code/sdk-runtime-patterns): Custom tools, system prompts, streaming, structured output, tool search, user approval, and slash commands. - [Agent SDK streaming and plugins](https://docs.passion8.cc/en/docs/claude-code/sdk-streaming-plugins): Streaming input, single messages, plugin loading, skill namespaces, permission pauses, and cache effects. - [Agent SDK production deployment](https://docs.passion8.cc/en/docs/claude-code/sdk-production): Session storage, tenant isolation, OTEL, cost tracking, structured output, tool search, and 5m/1h caching. - [Interactive pages with artifacts](https://docs.passion8.cc/en/docs/claude-code/artifacts): Publish Claude Code output as interactive pages and use local alternatives with Passion8. ## Costs and troubleshooting - [Monitoring and analytics](https://docs.passion8.cc/en/docs/claude-code/monitoring): OpenTelemetry, analytics dashboards, traceparent, privacy settings, and Passion8 observability boundaries. - [Prompt caching](https://docs.passion8.cc/en/docs/claude-code/prompt-caching): 5-minute and 1-hour TTL, invalidation, MCP, Passion8 gateway behavior, and usage fields. - [Cost optimization](https://docs.passion8.cc/en/docs/claude-code/cost-saving): Cost strategies for /clear, /compact, /context, models, MCP, and hooks. - [Error reference](https://docs.passion8.cc/en/docs/claude-code/error-reference): Runtime API/HTTP, 529, 500, rate limits, authentication, network, oversized requests, model, and thinking errors. - [Troubleshooting](https://docs.passion8.cc/en/docs/claude-code/troubleshooting): Authentication, Base URL, models, settings, hooks, MCP, permissions, cache, and safe mode diagnosis. ## Product entry points and boundaries - [Desktop and IDE extensions](https://docs.passion8.cc/en/docs/claude-code/desktop): Boundaries between Claude Desktop, Claude Code Desktop, IDE extensions, and MCP bridges. - [Desktop, Web, and IDE workflows](https://docs.passion8.cc/en/docs/claude-code/desktop-web-ide): Desktop quickstart, Linux beta, scheduled tasks, Web, Remote Control, VS Code, JetBrains, and Slack. - [Platforms and integrations](https://docs.passion8.cc/en/docs/claude-code/platforms-integrations): Entry-point boundaries for CLI, VS Code, JetBrains, Desktop, Web, Slack, CI/CD, Code Review, Ultraplan, and Ultrareview. - [Code Review and CI](https://docs.passion8.cc/en/docs/claude-code/review-ci): Official Code Review, Ultrareview, Ultraplan, GitHub Actions, GitLab CI/CD, and Passion8 connection boundaries. - [Chrome and computer use](https://docs.passion8.cc/en/docs/claude-code/chrome-computer-use): Browser automation, macOS desktop control, permissions, security boundaries, and cache effects. - [Web, Remote Control, and mobile](https://docs.passion8.cc/en/docs/claude-code/remote-web): Claude Code on the web, Remote Control, /teleport, /schedule, and Passion8 boundaries. - [Glossary](https://docs.passion8.cc/en/docs/claude-code/glossary): Agentic loop, MCP, hooks, skills, subagents, channels, ZDR, worktrees, and caching terms. - [Security](https://docs.passion8.cc/en/docs/security): API keys, permissions, hooks, MCP, and gateway security essentials. Need an account or balance? Start with [Quickstart](https://docs.passion8.cc/en/docs/quickstart) and [Top-ups and billing](https://docs.passion8.cc/en/docs/billing). ## Accounts, costs, and troubleshooting If you do not have an API key, follow [Quickstart](https://docs.passion8.cc/en/docs/quickstart) to create an account and token. See [Top-ups and billing](https://docs.passion8.cc/en/docs/billing) for balance and charging details; the client's official subscription and your Passion8 API balance are separate. For authentication, Base URL, or unavailable-model issues, see [FAQ](https://docs.passion8.cc/en/docs/faq). The console is authoritative for currently available models and prices.