# Claude Code 平台与集成

> Claude Code 在 CLI、IDE、Desktop、Web、移动端、Chrome、Slack、GitHub Actions、GitLab CI、Code Review、Ultraplan 和 Ultrareview 中的入口边界与 Passion8 接入建议。

URL: https://docs.passion8.cc/docs/claude-code/platforms-integrations
Language: zh-CN
Publisher: Passion8

官方把 Claude Code 拆成多个运行入口和集成入口。接入 Passion8 时,先判断“模型请求在哪里发出”,再判断“工具和代码在哪里执行”。这比单纯看 UI 名称更可靠。

Desktop quickstart、Linux beta、scheduled tasks、Claude Code on the web、Remote Control、VS Code、JetBrains 和 Slack 的细节见 [Desktop、Web 与 IDE 工作流](https://docs.passion8.cc/docs/claude-code/desktop-web-ide)。




Passion8 主要覆盖本地 Claude Code CLI、IDE 扩展和可显式设置 `ANTHROPIC_BASE_URL` 的自动化环境。Claude Code on the web、Slack、Remote Control、官方 Code Review 和云端 Ultrareview 通常依赖 Anthropic 账号、GitHub 连接和官方云端环境,不会自动继承你本机的 Passion8 Token。




## 运行入口矩阵

| 入口 | 代码/命令运行位置 | 模型请求配置 | Passion8 建议 |
| --- | --- | --- | --- |
| CLI | 本机 shell | `ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`settings.json` | 首选 |
| VS Code 扩展 | IDE 里的 Claude Code 进程 | 扩展环境变量或 Claude Code settings | 推荐,但要确认 IDE 继承环境 |
| JetBrains 插件 | IDE 里的 Claude Code 进程 | Claude Code settings 或插件设置 | 推荐,远程开发/WSL 要单独测 |
| Claude Code Desktop | Desktop 管理的本地/组织环境 | 取决于 Desktop 和组织策略 | 个人接入优先回到 CLI |
| Claude Code on the web | Anthropic 云端 sandbox | 官方云端连接器和 secrets | 不自动走本机 Passion8 |
| Remote Control | 本机 session,远程端只发指令 | 本机会话当前配置 | 自定义 Base URL 可能影响配对 |
| Slack | Anthropic 托管 session | 官方 Slack/GitHub 连接 | 通常不是 Passion8 接入口 |
| GitHub Actions / GitLab CI | CI runner | CI secret 和 action/job 配置 | 可接 Passion8,但要显式注入 env |
| Code Review / Ultrareview | 官方云端 review | 官方账号、GitHub App、spend cap | 通常按官方计费和限制 |

## IDE: VS Code 和 JetBrains

IDE 入口适合日常编码,因为它能直接引用当前文件、diff、终端输出和编辑器状态。

| 能力 | VS Code | JetBrains |
| --- | --- | --- |
| 文件/文件夹引用 | 支持 `@` mention | 通过插件上下文和 IDE 选择 |
| 多会话 | 支持多个 conversation/tab | 支持从 IDE 或外部终端启动 |
| Git 工作流 | commit、PR、worktree 辅助 | 依赖 IDE Git 集成和 CLI |
| Chrome 自动化 | VS Code 文档有专门入口 | 通常回到 CLI/浏览器工具 |
| 远程开发 | Dev Containers、SSH、WSL 要看扩展安装位置 | Remote Development、WSL 要确认 binary 路径 |

VS Code 里最稳的 Passion8 配置是写进扩展环境变量:

```json title="VS Code settings.json"
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://passion8.cc" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的 Passion8 API Key" }
  ]
}
```

JetBrains 里先确认 IDE 能找到 `claude`:

```bash
which claude
claude doctor
```

远程开发、WSL 或 Gateway 场景里,IDE 看到的 PATH、Node、证书和环境变量可能不是你本机终端那一套。遇到扩展没响应,先回到 [安装与登录排错](https://docs.passion8.cc/docs/claude-code/install-troubleshooting) 和 [配置调试与 .claude 目录](https://docs.passion8.cc/docs/claude-code/configuration-debugging)。

## CI/CD: GitHub Actions 和 GitLab

CI 入口适合自动生成 MR/PR、修测试、响应 issue、按规则执行 review。接 Passion8 时,关键是把 Base URL 和 Token 放进 CI secret,不要依赖开发者本机配置。

```yaml title=".github/workflows/claude.yml"
env:
  ANTHROPIC_BASE_URL: https://passion8.cc
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.PASSION8_API_KEY }}
```

```yaml title=".gitlab-ci.yml"
variables:
  ANTHROPIC_BASE_URL: "https://passion8.cc"
  ANTHROPIC_AUTH_TOKEN: "$PASSION8_API_KEY"
```

CI 里建议:

| 项目 | 建议 |
| --- | --- |
| 权限 | 用最小 token,限制仓库权限和分支权限 |
| 上下文 | 提供 issue、MR/PR diff、失败日志,不要把整个仓库塞进 prompt |
| 缓存 | 同一 job 内模型和 effort 固定,5m TTL 才有机会热起来 |
| 并发 | 不要让多个 job 同时打同一超长上下文 |
| 日志 | 避免把 Key、客户数据、完整生产日志写进 job log |

如果任务是“被评论 @claude 后自动处理”,官方 GitHub/GitLab 集成会有自己的 app 权限、触发条件和安全模型。Passion8 下更可控的做法是先用 headless CLI 明确写 workflow,详见 [Headless 自动化](https://docs.passion8.cc/docs/claude-code/headless)。

## Slack、移动端和云端任务

Slack、Claude mobile、Claude Code on the web 更适合“远程派发任务”和“离开终端后继续看进度”。它们通常依赖官方账号和云端 session。

| 场景 | 适合入口 | Passion8 边界 |
| --- | --- | --- |
| 手机上继续本机任务 | Remote Control | 本地模型请求仍看本机配置,但配对可能要求官方账号 |
| 浏览器里给 GitHub issue 派任务 | Claude Code on the web | 云端不继承本机 Passion8 env |
| Slack 里让 Claude 开 session | Slack 集成 | 依赖官方 Slack/GitHub 连接 |
| 云端计划,本地执行 | `/ultraplan` 后回终端 | 执行阶段回到本机才可能走 Passion8 |
| 云端深度 review | `/code-review ultra`、`/ultrareview` | 官方云端能力,按官方限制和计费 |

云端 session 如果要访问私有包源、内部 API 或企业代理,需要在官方云端环境里配置 secrets、setup script 和 allowlist。本机 `.zshrc`、`~/.claude/settings.json` 和 Passion8 Token 不会自动同步过去。

## Code Review、Ultraplan 和 Ultrareview

| 能力 | 入口 | 适合 | 注意 |
| --- | --- | --- | --- |
| `/code-review` | 本地或 PR review | 常规 diff 审查 | 本地模式更容易沿用 Passion8 |
| 官方 Code Review | GitHub App / check run | PR 自动审查 | 依赖官方 GitHub 集成、spend cap 和权限 |
| `/ultraplan` | CLI 启动,云端计划 | 复杂任务先做深计划 | 执行可选 web 或回终端 |
| `/ultrareview` | 云端多 agent review | 合并前找深层 bug | 云端独立上下文和缓存 |

如果你希望成本和 Provider 都走 Passion8,优先用本地 `/code-review` 或 headless `claude -p` 审查 diff。需要官方云端深度能力时,要把它当作另一条执行链,不要假设和本地 5m/1h prompt cache 共用。

更完整的 review、Ultrareview、Ultraplan、GitHub Actions 和 GitLab CI/CD 配置见 [Code Review 与 CI](https://docs.passion8.cc/docs/claude-code/review-ci)。

## Agent Teams 和 Channels

Agent Teams 和 Channels 属于更高级的协作/事件入口:

| 功能 | 作用 | 使用建议 |
| --- | --- | --- |
| Agent Teams | 多个 Claude Code session 作为团队协作 | 适合大规模 review、互相验证、并行假设探索 |
| Channels | MCP server 把 CI、告警、聊天事件推入运行中 session | 适合让 Claude 响应外部事件 |
| Channels reference | 定义通知格式、reply tool、权限 relay | 需要自己写 MCP/channel 插件时再读 |

这些能力会增加并行 token 和权限复杂度。接 Passion8 时,先确认网关是否完整转发工具、MCP、缓存和 channel 相关字段。网关字段缺失时,优先看 [网关与协议](https://docs.passion8.cc/docs/claude-code/gateway)。

更完整的 teammate、channel MCP、permission relay 和企业控制见 [Agent Teams 与 Channels](https://docs.passion8.cc/docs/claude-code/agent-teams-channels)。

## 缓存和成本影响

| 动作 | 5m / 1h 缓存影响 |
| --- | --- |
| 同一 CLI/IDE session 连续工作 | 前缀稳定,5m 或 1h TTL 都能持续刷新 |
| 从 IDE 切到 CLI | 如果目录、模型、effort、system prompt 相同,部分前缀可能仍可复用 |
| 从本地切到 web/Slack/cloud review | 通常是另一套 session 和 provider,不要指望共享缓存 |
| CI 每个 job 新启动 | 项目前缀可短时间复用,但不同 runner/env 可能改变 cache key |
| `/ultrareview` 或 agent teams | 子任务各自建立缓存,总 token 会增加 |

逐命令规则看 [命令与缓存影响](https://docs.passion8.cc/docs/claude-code/command-cache),底层 TTL 看 [Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching)。

## 官方参考

- [Platforms and integrations](https://code.claude.com/docs/en/platforms.md)
- [Use Claude Code in VS Code](https://code.claude.com/docs/en/vs-code.md)
- [JetBrains IDEs](https://code.claude.com/docs/en/jetbrains.md)
- [Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions.md)
- [Claude Code GitLab CI/CD](https://code.claude.com/docs/en/gitlab-ci-cd.md)
- [Claude Code in Slack](https://code.claude.com/docs/en/slack.md)
- [Code Review](https://code.claude.com/docs/en/code-review.md)
- [Ultraplan](https://code.claude.com/docs/en/ultraplan.md)
- [Ultrareview](https://code.claude.com/docs/en/ultrareview.md)
- [Agent teams](https://code.claude.com/docs/en/agent-teams.md)
- [Channels](https://code.claude.com/docs/en/channels.md)