Desktop、Web 与 IDE 工作流
Desktop quickstart、Linux beta、scheduled tasks、Claude Code on the web、deep links、Remote Control、VS Code、JetBrains 和 Slack 的入口边界。
Claude Code 现在有多个入口:CLI、Desktop Code tab、VS Code、JetBrains、claude.ai/code、Remote Control、Slack 和云端例行任务。它们跑的是同一类 agent 能力,但配置来源、文件访问、网络边界和缓存行为不同。
如果你只关心 Passion8 怎么接入桌面和 IDE,先看 桌面版与 IDE 扩展。本页做工作流横向梳理。
#入口对照
| 入口 | 运行位置 | 文件访问 | 适合 |
|---|---|---|---|
| CLI | 本机终端 | 当前工作目录 | 最明确的 Passion8 接入和排错 |
| VS Code | 编辑器集成终端/扩展 | 当前工作区和选择上下文 | 边写边改、inline diff、诊断共享 |
| JetBrains | IDE 插件加 CLI | 项目根和 IDE 选择上下文 | IntelliJ、PyCharm、WebStorm 等 |
| Desktop Local | 本机 Desktop app | 本地文件、diff、terminal、preview | 多会话图形化工作区 |
| Desktop Remote | Anthropic 云 | 远端环境或 fresh clone | 长任务、可关闭本机继续 |
| Claude Code on web | claude.ai/code 云端 | GitHub repo 和云环境 | 浏览器、手机、PR 流程 |
| Remote Control | 本机会话加网页/手机遥控 | 本机 CLI session | 离开电脑后继续批准和追问 |
| Slack | Slack 线程触发 web session | 取决于连接的 repo | 从团队讨论派发任务 |
#Desktop quickstart
Desktop app 的 Code tab 面向图形化 Claude Code 工作。它内置 Claude Code,不要求用户先装 Node.js 或 CLI。
| 功能 | 说明 |
|---|---|
| Local | 直接访问本机文件,适合真实开发 |
| Remote | 运行在云端,适合长任务 |
| SSH | 连接远端机器,首次会自动安装 Claude Code |
| Diff view | 每个文件改动可接受或拒绝 |
| Preview | 在 Desktop 内跑 dev server 并让 Claude 检查 |
| PR monitoring | 监控 CI,可协助修复失败 |
| Side chat | 不打断主会话地问问题 |
| Parallel sessions | 多任务并行,通常结合 worktree 隔离 |
Desktop 的 Code tab 默认更偏“人审阅再接受”。如果目标是最快验证 Passion8 Base URL,仍建议先用 CLI:
ANTHROPIC_BASE_URL=https://passion8.cc \
ANTHROPIC_AUTH_TOKEN=sk-xxx \
claude -p "ping"#Linux Desktop beta
Linux Desktop 支持 Ubuntu 22.04+ 和 Debian 12+,x86_64 或 arm64。
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktopLinux beta 当前要注意:
| 项目 | 状态 |
|---|---|
| Chat、Cowork、Code | 可用 |
| Computer Use | Linux Desktop beta 暂不可用 |
| Dictation | Desktop 内不可用,可用 CLI 语音输入替代 |
| Wayland global hotkey | 依赖桌面环境 portal |
| Fedora/RHEL | 不是当前官方支持目标 |
#Desktop scheduled tasks
Desktop scheduled tasks 适合本机定时任务。它不同于云端 routines 和 CLI /loop。
| 方案 | 运行位置 | 机器是否要开 | 适合 |
|---|---|---|---|
| Cloud routines | Anthropic 云 | 不需要 | 可靠定时、API/GitHub 触发 |
| Desktop scheduled tasks | 本机 Desktop | 需要 | 访问本地文件和工具 |
/loop | 当前 CLI session | 需要且会话要在 | 快速轮询、临时提醒 |
创建 Desktop task 时要关注:
| 字段 | 建议 |
|---|---|
| Instructions | 像普通 prompt 一样写清目标、验收和限制 |
| Working directory | 指向具体 repo |
| Permission mode | 定时任务通常要更保守 |
| Worktree toggle | 建议打开,避免污染当前工作区 |
| MCP/connectors | 只启用任务必要的工具 |
#Claude Code on the web
Web 入口运行在 Anthropic 云端,常见流程是连接 GitHub repo、配置环境、提交任务、查看 PR。它适合从手机或浏览器派发任务,也适合把长任务从本地转到云端。
| 配置 | 作用 |
|---|---|
| Cloud environment | 依赖安装、构建命令、测试脚本 |
| Setup script | 每次会话准备环境 |
| Network access | 允许访问私有 registry、API 或内网代理 |
| Docker | 需要更可控环境时使用 |
--remote | 从 CLI 创建远端任务 |
--teleport | 把本地上下文迁移到 web |
Passion8 侧要注意:Web 云端会话是否能走第三方网关取决于官方支持的组织/网关配置,不是本机 ~/.claude/settings.json。
#Remote Control
Remote Control 让你从手机、平板或浏览器继续控制本地 Claude Code session。它适合临时离开电脑但还要批准、回答问题或查看进度。
| 点 | 说明 |
|---|---|
| 本体 | 本地 CLI session 仍在你电脑上运行 |
| 访问 | 通过 claude.ai/code 或移动端继续 |
| 文件 | 仍是本机文件,不是云端 fresh clone |
| 安全 | 不要在不信任网络或共享机器上开放 |
| 缓存 | 本地会话前缀不变,批准和回复会追加消息 |
如果你需要可靠无人值守,Remote Control 不如 cloud routines。它更像“远程接管正在跑的本机会话”。
#Deep links
Deep links 用 claude-cli:// 从网页、告警、runbook 或 dashboard 打开本地 Claude Code。
| 用途 | 例子 |
|---|---|
| 事故 runbook | 一键打开 repo 并带上排障 prompt |
| CI 失败 | 从 dashboard 打开本地修复会话 |
| 内部平台 | 对某个服务、目录或 issue 预填上下文 |
设计 deep link 时不要塞 secrets。敏感数据应该由本地环境或受控工具读取。
#VS Code
VS Code 扩展适合把编辑器选择、诊断和 diff 带进 Claude Code。
| 能力 | 说明 |
|---|---|
| 当前选择 | 选择文本可作为上下文 |
@file | 引用文件或行范围 |
| Inline diff | 在编辑器里审阅改动 |
| Diagnostics | TypeScript、lint、测试错误可共享 |
| Remote sessions | 可查看 web 端 GitHub session 历史 |
| Usage dialog | /usage 看账号、计划和使用归因 |
如果 VS Code 里扩展没读到 Passion8 环境变量,在 VS Code settings 里显式配置:
{
"claude-code.environmentVariables": {
"ANTHROPIC_BASE_URL": "https://passion8.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
}
}#JetBrains
JetBrains 插件不内置 CLI,它会运行你的 claude 命令并与 IDE 连接。
| 功能 | 说明 |
|---|---|
| 快速启动 | macOS Cmd+Esc,Windows/Linux Ctrl+Esc |
| IDE diff | 改动显示在 JetBrains diff viewer |
| 选择上下文 | 当前 selection 或 tab 可共享 |
| 文件引用 | 插入 @src/file.ts#L1-99 |
| 诊断共享 | IDE 错误和 warnings 可进上下文 |
| WSL | 可能要配置防火墙或 mirrored networking |
如果 IDE 找不到 CLI,在插件设置里写完整命令,例如 /usr/local/bin/claude 或 WSL 命令。
#Slack
Slack 入口会把 @Claude 的 coding task 路由到 Claude Code on the web。每个用户用自己的 Claude 账号和连接的 GitHub repo。
| 项目 | 注意 |
|---|---|
| Routing mode | Code only 或 Code + Chat |
| Channel context | Claude 会读取线程或近期频道上下文 |
| Repo access | 用户只能访问自己连接的 repo |
| Progress | 状态更新回 Slack thread |
| PR | 完成后可查看 session 或创建 PR |
Slack 中的上下文可能包含其他人的消息。只在可信频道使用,并避免把 secrets 写进线程。
#缓存和成本
| 入口 | 5m/1h cache 影响 |
|---|---|
| CLI/IDE 本地连续会话 | 最容易复用前缀,适合 1 小时 TTL |
| Desktop 多 session | 每个 session 独立上下文,不要期待跨 session 命中 |
| Web/Remote cloud | 取决于云环境和组织 Provider,本机缓存不可复用 |
| Remote Control | 继续同一本机会话,通常只追加远程回复 |
| Slack | 新 web session 通常从新前缀开始 |
| Scheduled tasks | 每次 run 是否命中取决于 setup、工具和上下文是否稳定 |
大量 IDE selection、诊断、插件和 MCP 工具会改变前缀。出现成本异常时,优先看 /usage、cache_creation_input_tokens 和 MCP 工具定义是否 upfront 加载。
#官方参考
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

