Claude Code
Claude Code 接入 Passion8 总览:先按 macOS / Windows 安装 CLI、桌面端和官方 IDE 插件,再用手动配置或 CC-Switch 固定接入 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。
#学习与工作流
接入跑通后,再理解 Claude Code 的运行方式、命令体系和团队工作流。
工作原理与扩展地图理解 agentic loop、模型、工具、上下文加载、扩展能力和缓存成本。官方覆盖地图审计官方 163 个 Markdown 页面、101 个 slash commands 和本地中文聚合入口。命令大全CLI flags、斜杠命令、后台 agent、审查、快捷键与权限模式。命令与缓存影响逐命令解释 5 分钟/1 小时 TTL、模型、effort、fast mode、MCP 和后台 agent 的缓存影响。交互模式与终端体验键盘快捷键、Vim mode、shell mode、后台 Bash、tmux、fullscreen、语音输入和缓存影响。CLI 与终端参考CLI 命令、安装渠道、环境变量、PATH、终端快捷键、fullscreen、语音输入和 deep links。最佳实践与工作流把探索、计划、实现、验证、Review、子代理和 headless 脚本串成可执行流程。Prompt 模板与团队推广可复制的探索、实现、debug、review、发布、champion 和 rollout prompt。
#上下文与会话
模型、Effort 与 Fast Mode/model、/effort、opusplan、fallback、Advisor、1M context 和 fast mode。功能可用性与 Provider 差异Claude subscription、Anthropic API、Passion8 网关和第三方 provider 的能力边界。记忆与规则CLAUDE.md、auto memory、.claude/rules、AGENTS.md 兼容方式。输出风格Default、Proactive、Explanatory、Learning、自定义 output-styles 和缓存影响。上下文窗口/context、文件读取、rules、hooks、compact 和窗口占用控制。大型代码库与 Monorepo启动目录、分层 CLAUDE.md、Read deny、稀疏 Worktree、跨包访问和目录级 Skills。会话管理resume、branch、rename、transcript、/cd、/clear 与 /compact 的边界。Checkpoint 与回退/rewind、检查点恢复、只恢复代码或只恢复对话,以及和 Git 的边界。
#安全与治理
权限与模式allow/ask/deny、default/plan/auto/dontAsk/bypassPermissions 规则。Auto mode 策略参考配置 trusted infrastructure、allow/soft_deny/hard_deny、classifyAllShell 和 denial 复盘。沙箱与隔离环境Bash 沙箱、Sandbox runtime、Dev Container、Docker、VM、网络和凭据边界。Sandbox 与 Dev Container比较 sandbox、Dev Container、自定义容器、VM、凭据保护和缓存边界。企业部署总览按 provider、认证、managed settings、权限、监控和数据边界规划组织部署。企业网络与集中管控代理、CA、mTLS、server-managed settings、endpoint-managed settings 和 managed MCP。企业控制面与受管配置server-managed settings、endpoint-managed settings、managed MCP、Auto mode、analytics 和合规清单。企业 rollout把 provider、网关、settings、MCP、观测、Auto mode 和培训按阶段推到团队。组织推广与沟通套件Champion、launch announcement、drip campaign、FAQ、试点反馈和 Passion8 沟通口径。数据使用与隐私说明训练策略、保留周期、本地明文 transcript、Telemetry、WebFetch 和 Passion8 网关边界。Zero Data RetentionZDR 覆盖范围、禁用能力、本地 transcript、网关日志和缓存误区。安全说明API Key、权限、Hooks、MCP 与网关安全要点。
#扩展与自动化
工具参考Read/Edit/Bash/Grep/Agent/Monitor 等工具、权限规则和 Hook matcher。子代理内置 Explore/Plan/general-purpose、自定义 agents、权限、模型和上下文隔离。多代理、后台与 WorkflowsAgent View、/background、/batch、/fork、/goal、/loop 和 dynamic workflows。高级工作流与云端协作Advisor、Agent View、/goal、dynamic workflows、Routines、Ultraplan 和 Ultrareview 的选择边界。Agent Teams 与 Channels多 Claude session 团队协作、外部事件推送、permission relay 和 channel MCP 边界。Routines 与 /loop 调度本地循环、Cron、云端 routines、/schedule、API/GitHub 触发和 TTL 策略。Worktrees 并行工作区--worktree、PR worktree、.worktreeinclude、清理策略和 subagent 隔离。MCP 工具接入HTTP、SSE、stdio、WebSocket、OAuth、作用域、tool search 和网关注意事项。网关与协议Passion8 Base URL、headers/body 透传、模型发现、cache 字段和常见 400/401。Gateway 协议上线清单协议格式、headers/body、attribution、模型发现、spend limits、错误语义和缓存验收。Gateway 运维Claude apps gateway、通用协议、OIDC、Postgres、spend limits、模型发现和缓存透传。Claude apps gateway 部署私网入口、OIDC、Kubernetes、Cloud Run、GCP、Postgres、健康检查和升级。Hooks 自动化PreToolUse、PostToolUse、ConfigChange、FileChanged 等生命周期自动化。插件与 Skillsplugin manifest、skills、agents、hooks、MCP、LSP 和 marketplace 分发。插件市场与分发官方市场、社区市场、内部 marketplace、版本约束、推荐规则和安全插件。状态栏/statusline、上下文占用、成本、Git、PR、rate limit 和本地脚本性能。Headless 自动化claude -p、--bare、JSON/stream-json、CI 脚本、结构化输出和后台等待。Agent SDK在 TypeScript/Python 产品里嵌入 Claude Code agent loop。Agent SDK API 参考速查TypeScript/Python 安装、query、ClaudeSDKClient、工具函数、session API、settings 解析和迁移。Agent SDK Agent 能力agent loop、settingSources、sessions、skills、subagents、todo tracking、checkpointing 和 hosting 限制。Agent SDK 能力矩阵权限评估、Hooks、MCP、SessionStore、成本追踪、OTEL、安全部署和缓存策略。Agent SDK 运行时模式custom tools、system prompt、streaming、structured output、tool search、用户审批和 slash commands。Agent SDK Streaming 与插件Streaming input、single message、插件加载、技能命名空间、权限暂停和缓存影响。Agent SDK 生产部署会话存储、租户隔离、OTEL、成本追踪、结构化输出、tool search 和 5m/1h 缓存策略。Artifacts 交互页面把 Claude Code 输出发布成交互页面,以及 Passion8 下的本地替代方案。
#成本与排错
监控与分析OpenTelemetry、analytics dashboard、traceparent、隐私开关和 Passion8 观测边界。Prompt 缓存5 分钟与 1 小时 TTL、缓存失效、MCP、Passion8 网关和 usage 字段。成本优化/clear、/compact、/context、模型、MCP、Hooks 的成本控制策略。错误参考运行时 API/HTTP、529、500、限流、认证、网络、请求过大、模型和 thinking 错误。常见问题鉴权、Base URL、模型、settings、Hooks、MCP、权限、缓存和 safe mode 排错。
#入口边界
桌面版与 IDE 扩展Claude Desktop、Claude Code Desktop、IDE 扩展和 MCP 桥接边界。Desktop、Web 与 IDE 工作流Desktop quickstart、Linux beta、scheduled tasks、Web、Remote Control、VS Code、JetBrains 和 Slack。平台与集成CLI、VS Code、JetBrains、Desktop、Web、Slack、CI/CD、Code Review、Ultraplan 和 Ultrareview 的入口边界。Code Review 与 CI官方 Code Review、Ultrareview、Ultraplan、GitHub Actions、GitLab CI/CD 和 Passion8 接入边界。Chrome 与 Computer Use浏览器自动化、macOS 桌面控制、权限、安全边界和缓存影响。Web、远程控制与移动端Claude Code on the web、Remote Control、/teleport、/schedule 和 Passion8 边界。术语表agentic loop、MCP、Hooks、Skills、Subagent、Channel、ZDR、Worktree 和缓存术语。安全说明API Key、权限、Hooks、MCP 与网关安全要点。
Support / 支持
Need help? / 需要帮助?
接入、计费与模型异常可邮件联系;服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.
也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right

