# Claude Code > Claude Code 接入 Passion8 总览:先按 macOS / Windows 安装 CLI、桌面端和官方 IDE 插件,再用手动配置或 CC-Switch 固定接入 Passion8。 URL: https://docs.passion8.cc/docs/claude-code Language: zh-CN Publisher: Passion8 Claude Code 是 Anthropic 官方 agentic coding 工具,可在终端、IDE、桌面和网页形态中工作。接入 Passion8 的核心是把 Claude Code 的 Anthropic 兼容请求路由到 `https://passion8.cc`。 Claude Code 的 Base URL 是 `https://passion8.cc`,不带 `/v1`。Codex/OpenAI 兼容客户端才使用 `https://passion8.cc/v1`。 ## 接入步骤 第一优先级是先安装,再配置。配置只保留两条路:手动写配置,或用 CC-Switch 固定填写 Passion8。 - [安装教程](https://docs.passion8.cc/docs/claude-code/install): macOS / Windows 安装 CLI、桌面端和官方 IDE 插件。 - [配置教程](https://docs.passion8.cc/docs/claude-code/settings): 手动配置或用 CC-Switch 接入 Passion8。Base URL 不带 /v1。 ## 学习与工作流 接入跑通后,再理解 Claude Code 的运行方式、命令体系和团队工作流。 - [工作原理与扩展地图](https://docs.passion8.cc/docs/claude-code/how-it-works): 理解 agentic loop、模型、工具、上下文加载、扩展能力和缓存成本。 - [官方覆盖地图](https://docs.passion8.cc/docs/claude-code/official-coverage-map): 审计官方 163 个 Markdown 页面、101 个 slash commands 和本地中文聚合入口。 - [命令大全](https://docs.passion8.cc/docs/claude-code/commands): CLI flags、斜杠命令、后台 agent、审查、快捷键与权限模式。 - [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache): 逐命令解释 5 分钟/1 小时 TTL、模型、effort、fast mode、MCP 和后台 agent 的缓存影响。 - [交互模式与终端体验](https://docs.passion8.cc/docs/claude-code/interactive-terminal): 键盘快捷键、Vim mode、shell mode、后台 Bash、tmux、fullscreen、语音输入和缓存影响。 - [CLI 与终端参考](https://docs.passion8.cc/docs/claude-code/cli-terminal-reference): CLI 命令、安装渠道、环境变量、PATH、终端快捷键、fullscreen、语音输入和 deep links。 - [最佳实践与工作流](https://docs.passion8.cc/docs/claude-code/best-practices-workflows): 把探索、计划、实现、验证、Review、子代理和 headless 脚本串成可执行流程。 - [Prompt 模板与团队推广](https://docs.passion8.cc/docs/claude-code/prompt-library): 可复制的探索、实现、debug、review、发布、champion 和 rollout prompt。 ## 上下文与会话 - [模型、Effort 与 Fast Mode](https://docs.passion8.cc/docs/claude-code/model-fast-mode): /model、/effort、opusplan、fallback、Advisor、1M context 和 fast mode。 - [功能可用性与 Provider 差异](https://docs.passion8.cc/docs/claude-code/feature-availability): Claude subscription、Anthropic API、Passion8 网关和第三方 provider 的能力边界。 - [记忆与规则](https://docs.passion8.cc/docs/claude-code/memory): CLAUDE.md、auto memory、.claude/rules、AGENTS.md 兼容方式。 - [输出风格](https://docs.passion8.cc/docs/claude-code/output-styles): Default、Proactive、Explanatory、Learning、自定义 output-styles 和缓存影响。 - [上下文窗口](https://docs.passion8.cc/docs/claude-code/context): /context、文件读取、rules、hooks、compact 和窗口占用控制。 - [大型代码库与 Monorepo](https://docs.passion8.cc/docs/claude-code/large-codebases): 启动目录、分层 CLAUDE.md、Read deny、稀疏 Worktree、跨包访问和目录级 Skills。 - [会话管理](https://docs.passion8.cc/docs/claude-code/sessions): resume、branch、rename、transcript、/cd、/clear 与 /compact 的边界。 - [Checkpoint 与回退](https://docs.passion8.cc/docs/claude-code/checkpointing): /rewind、检查点恢复、只恢复代码或只恢复对话,以及和 Git 的边界。 ## 安全与治理 - [权限与模式](https://docs.passion8.cc/docs/claude-code/permissions): allow/ask/deny、default/plan/auto/dontAsk/bypassPermissions 规则。 - [Auto mode 策略参考](https://docs.passion8.cc/docs/claude-code/auto-mode-policy): 配置 trusted infrastructure、allow/soft_deny/hard_deny、classifyAllShell 和 denial 复盘。 - [沙箱与隔离环境](https://docs.passion8.cc/docs/claude-code/sandboxing): Bash 沙箱、Sandbox runtime、Dev Container、Docker、VM、网络和凭据边界。 - [Sandbox 与 Dev Container](https://docs.passion8.cc/docs/claude-code/sandbox-devcontainers): 比较 sandbox、Dev Container、自定义容器、VM、凭据保护和缓存边界。 - [企业部署总览](https://docs.passion8.cc/docs/claude-code/enterprise-deployment-overview): 按 provider、认证、managed settings、权限、监控和数据边界规划组织部署。 - [企业网络与集中管控](https://docs.passion8.cc/docs/claude-code/enterprise-admin): 代理、CA、mTLS、server-managed settings、endpoint-managed settings 和 managed MCP。 - [企业控制面与受管配置](https://docs.passion8.cc/docs/claude-code/enterprise-controls): server-managed settings、endpoint-managed settings、managed MCP、Auto mode、analytics 和合规清单。 - [企业 rollout](https://docs.passion8.cc/docs/claude-code/enterprise-rollout): 把 provider、网关、settings、MCP、观测、Auto mode 和培训按阶段推到团队。 - [组织推广与沟通套件](https://docs.passion8.cc/docs/claude-code/adoption-communications): Champion、launch announcement、drip campaign、FAQ、试点反馈和 Passion8 沟通口径。 - [数据使用与隐私](https://docs.passion8.cc/docs/claude-code/data-usage): 说明训练策略、保留周期、本地明文 transcript、Telemetry、WebFetch 和 Passion8 网关边界。 - [Zero Data Retention](https://docs.passion8.cc/docs/claude-code/zero-data-retention): ZDR 覆盖范围、禁用能力、本地 transcript、网关日志和缓存误区。 - [安全说明](https://docs.passion8.cc/docs/security): API Key、权限、Hooks、MCP 与网关安全要点。 ## 扩展与自动化 - [工具参考](https://docs.passion8.cc/docs/claude-code/tools): Read/Edit/Bash/Grep/Agent/Monitor 等工具、权限规则和 Hook matcher。 - [子代理](https://docs.passion8.cc/docs/claude-code/subagents): 内置 Explore/Plan/general-purpose、自定义 agents、权限、模型和上下文隔离。 - [多代理、后台与 Workflows](https://docs.passion8.cc/docs/claude-code/parallel-agents): Agent View、/background、/batch、/fork、/goal、/loop 和 dynamic workflows。 - [高级工作流与云端协作](https://docs.passion8.cc/docs/claude-code/advanced-workflows-cloud): Advisor、Agent View、/goal、dynamic workflows、Routines、Ultraplan 和 Ultrareview 的选择边界。 - [Agent Teams 与 Channels](https://docs.passion8.cc/docs/claude-code/agent-teams-channels): 多 Claude session 团队协作、外部事件推送、permission relay 和 channel MCP 边界。 - [Routines 与 /loop 调度](https://docs.passion8.cc/docs/claude-code/routines-scheduling): 本地循环、Cron、云端 routines、/schedule、API/GitHub 触发和 TTL 策略。 - [Worktrees 并行工作区](https://docs.passion8.cc/docs/claude-code/worktrees): --worktree、PR worktree、.worktreeinclude、清理策略和 subagent 隔离。 - [MCP 工具接入](https://docs.passion8.cc/docs/claude-code/mcp): HTTP、SSE、stdio、WebSocket、OAuth、作用域、tool search 和网关注意事项。 - [网关与协议](https://docs.passion8.cc/docs/claude-code/gateway): Passion8 Base URL、headers/body 透传、模型发现、cache 字段和常见 400/401。 - [Gateway 协议上线清单](https://docs.passion8.cc/docs/claude-code/gateway-protocol): 协议格式、headers/body、attribution、模型发现、spend limits、错误语义和缓存验收。 - [Gateway 运维](https://docs.passion8.cc/docs/claude-code/gateway-operations): Claude apps gateway、通用协议、OIDC、Postgres、spend limits、模型发现和缓存透传。 - [Claude apps gateway 部署](https://docs.passion8.cc/docs/claude-code/gateway-cloud-deployment): 私网入口、OIDC、Kubernetes、Cloud Run、GCP、Postgres、健康检查和升级。 - [Hooks 自动化](https://docs.passion8.cc/docs/claude-code/hooks): PreToolUse、PostToolUse、ConfigChange、FileChanged 等生命周期自动化。 - [插件与 Skills](https://docs.passion8.cc/docs/claude-code/plugins): plugin manifest、skills、agents、hooks、MCP、LSP 和 marketplace 分发。 - [插件市场与分发](https://docs.passion8.cc/docs/claude-code/plugin-marketplaces): 官方市场、社区市场、内部 marketplace、版本约束、推荐规则和安全插件。 - [状态栏](https://docs.passion8.cc/docs/claude-code/statusline): /statusline、上下文占用、成本、Git、PR、rate limit 和本地脚本性能。 - [Headless 自动化](https://docs.passion8.cc/docs/claude-code/headless): claude -p、--bare、JSON/stream-json、CI 脚本、结构化输出和后台等待。 - [Agent SDK](https://docs.passion8.cc/docs/claude-code/sdk): 在 TypeScript/Python 产品里嵌入 Claude Code agent loop。 - [Agent SDK API 参考速查](https://docs.passion8.cc/docs/claude-code/sdk-api-reference): TypeScript/Python 安装、query、ClaudeSDKClient、工具函数、session API、settings 解析和迁移。 - [Agent SDK Agent 能力](https://docs.passion8.cc/docs/claude-code/sdk-agent-features): agent loop、settingSources、sessions、skills、subagents、todo tracking、checkpointing 和 hosting 限制。 - [Agent SDK 能力矩阵](https://docs.passion8.cc/docs/claude-code/sdk-capabilities): 权限评估、Hooks、MCP、SessionStore、成本追踪、OTEL、安全部署和缓存策略。 - [Agent SDK 运行时模式](https://docs.passion8.cc/docs/claude-code/sdk-runtime-patterns): custom tools、system prompt、streaming、structured output、tool search、用户审批和 slash commands。 - [Agent SDK Streaming 与插件](https://docs.passion8.cc/docs/claude-code/sdk-streaming-plugins): Streaming input、single message、插件加载、技能命名空间、权限暂停和缓存影响。 - [Agent SDK 生产部署](https://docs.passion8.cc/docs/claude-code/sdk-production): 会话存储、租户隔离、OTEL、成本追踪、结构化输出、tool search 和 5m/1h 缓存策略。 - [Artifacts 交互页面](https://docs.passion8.cc/docs/claude-code/artifacts): 把 Claude Code 输出发布成交互页面,以及 Passion8 下的本地替代方案。 ## 成本与排错 - [监控与分析](https://docs.passion8.cc/docs/claude-code/monitoring): OpenTelemetry、analytics dashboard、traceparent、隐私开关和 Passion8 观测边界。 - [Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching): 5 分钟与 1 小时 TTL、缓存失效、MCP、Passion8 网关和 usage 字段。 - [成本优化](https://docs.passion8.cc/docs/claude-code/cost-saving): /clear、/compact、/context、模型、MCP、Hooks 的成本控制策略。 - [错误参考](https://docs.passion8.cc/docs/claude-code/error-reference): 运行时 API/HTTP、529、500、限流、认证、网络、请求过大、模型和 thinking 错误。 - [常见问题](https://docs.passion8.cc/docs/claude-code/troubleshooting): 鉴权、Base URL、模型、settings、Hooks、MCP、权限、缓存和 safe mode 排错。 ## 入口边界 - [桌面版与 IDE 扩展](https://docs.passion8.cc/docs/claude-code/desktop): Claude Desktop、Claude Code Desktop、IDE 扩展和 MCP 桥接边界。 - [Desktop、Web 与 IDE 工作流](https://docs.passion8.cc/docs/claude-code/desktop-web-ide): Desktop quickstart、Linux beta、scheduled tasks、Web、Remote Control、VS Code、JetBrains 和 Slack。 - [平台与集成](https://docs.passion8.cc/docs/claude-code/platforms-integrations): CLI、VS Code、JetBrains、Desktop、Web、Slack、CI/CD、Code Review、Ultraplan 和 Ultrareview 的入口边界。 - [Code Review 与 CI](https://docs.passion8.cc/docs/claude-code/review-ci): 官方 Code Review、Ultrareview、Ultraplan、GitHub Actions、GitLab CI/CD 和 Passion8 接入边界。 - [Chrome 与 Computer Use](https://docs.passion8.cc/docs/claude-code/chrome-computer-use): 浏览器自动化、macOS 桌面控制、权限、安全边界和缓存影响。 - [Web、远程控制与移动端](https://docs.passion8.cc/docs/claude-code/remote-web): Claude Code on the web、Remote Control、/teleport、/schedule 和 Passion8 边界。 - [术语表](https://docs.passion8.cc/docs/claude-code/glossary): agentic loop、MCP、Hooks、Skills、Subagent、Channel、ZDR、Worktree 和缓存术语。 - [安全说明](https://docs.passion8.cc/docs/security): API Key、权限、Hooks、MCP 与网关安全要点。 还没注册或没余额?先看 [快速开始](https://docs.passion8.cc/docs/quickstart) 与 [充值与账单](https://docs.passion8.cc/docs/billing)。 ## 账户、费用与排错 还没有 API Key 时，从 [快速开始](https://docs.passion8.cc/docs/quickstart) 创建账户和令牌。余额与费用口径见 [充值与账单](https://docs.passion8.cc/docs/billing)，不要把客户端的官方订阅与 Passion8 API 余额混用。鉴权、Base URL、模型不可用等问题见 [常见问题](https://docs.passion8.cc/docs/faq)；当前可用模型及价格以控制台为准。