選擇平臺與整合
Claude Code 同一套智慧體迴圈可以跑在 CLI、Desktop、IDE、Web、Mobile、Slack 和 CI/CD。選入口先看專案在哪裡、任務要不要長跑、你需不需要視覺審查。
Claude Code 不是隻有終端一種用法。真正的選擇題是:你的專案在哪裡、你想怎麼審查改動、任務能不能離開電腦繼續跑、團隊要不要從 Slack 或 CI 觸發。入口不同,底層 Agent 相同,工作邊界不同。——翔宇
這一章用 12 分鐘換什麼:前面三章完成了產品定位、安裝和登入。這一章幫你選入口:什麼時候用 CLI,什麼時候用 Desktop 或 IDE,什麼時候把任務交給 Web、Mobile、Slack、CI/CD 或 Remote Control。
1. 先問“專案在哪裡”
新手最容易問錯問題:
Claude Code 哪个平台最好?更好的問題是:
我的项目在哪里?我用什么方式审查结果?任务要不要离开电脑继续跑?官方 Platforms and integrations 文件的核心意思是:Claude Code 在各個入口使用同一套底層引擎(same underlying engine),但每個 surface(介面)面向不同工作方式。
所以不要把 CLI、Desktop、IDE、Web 看成互相替代。它們更像同一套 Agent(智慧體)的不同駕駛艙。
先用這張錶快速判斷:
| 你的主要需求 | 優先介面 |
|---|---|
| 專案在本機或遠端終端,想看完整工具鏈 | CLI |
| 主要在編輯器裡審 diff 和改小範圍程式碼 | VS Code / JetBrains |
| 需要視覺化預覽、並行會話、圖形化 diff | Desktop |
| 長任務要離開電腦繼續跑 | Claude Code on the Web |
| 團隊從聊天、PR 或 CI 觸發任務 | Slack / GitHub Actions / GitLab CI |
第一性原理:平臺選擇不是功能多寡排序,而是“Agent 執行在哪裡、上下文從哪裡來、結果怎麼審、風險由誰把關”。
2. 六個主要入口怎麼選
先看總表。
| 入口 | 最適合 | 你得到什麼 |
|---|---|---|
| CLI | 終端工作流、指令碼、遠端伺服器、本機完整工具鏈 | 最完整功能、Agent SDK、第三方供應商、macOS computer use |
| Desktop | 視覺審查、並行會話、差異和預覽 | 圖形介面、內建終端、檔案編輯器、PR 監控 |
| VS Code | 不想離開 VS Code | 行內差異、整合終端、檔案上下文 |
| JetBrains | IntelliJ、PyCharm、WebStorm 等 | 差異檢視器、選區共享、終端會話 |
| Web | 長任務、斷線後繼續跑、雲端儲存庫 | Anthropic 託管雲端會話 |
| Mobile | 離開電腦後發起或監控任務 | 雲端會話、Remote Control、Dispatch |
官方說 CLI 是 terminal-native work(終端原生工作)的最完整介面(surface)。原因是指令碼和 Agent SDK 都是 CLI-only(僅 CLI)。第三方 provider(供應商)也能在 VS Code 使用;Enterprise Desktop 支援 Vertex AI 和 gateway provider,但 Bedrock 或 Foundry 更適合走 CLI 或 VS Code。
Desktop 和 IDE 犧牲一些 CLI-only 能力,換來視覺審查和編輯器貼合。
Web 跑在 Anthropic cloud(Anthropic 雲端),所以你斷開連線後任務還能繼續。
Mobile 更像薄客戶端:要麼看 cloud session,要麼透過 Remote Control 接本機會話,要麼用 Dispatch 把任務發給 Desktop。
新手路線:先學 CLI,理解完整工作流;再按你的審查習慣加 Desktop 或 IDE;需要長任務再上 Web;團隊協作再接 Slack / CI。
3. CLI:先學它,因為它暴露最完整邊界
CLI 是最適合學習 Claude Code 的入口。
原因不是它“更高階”,而是它把關鍵邊界暴露得最清楚:
- 當前工作目錄是什麼。
- Git 狀態是什麼。
- 哪些命令真的跑了。
- 許可權彈出視窗對應哪個工具呼叫。
- 測試、lint、構建輸出是什麼。
- 環境變數和憑據來自哪個 shell。
典型啟動方式:
cd your-project
claude適合 CLI 的任務:
| 場景 | 為什麼 |
|---|---|
| 修 bug / 加功能 | 能直接讀寫專案和跑測試 |
| 遠端伺服器 | SSH 後直接進入專案目錄 |
| 指令碼和自動化 | CLI 引數、headless、Agent SDK 更自然 |
| 第三方供應商 | Bedrock / Vertex / Foundry 等多從 CLI 環境變數進入 |
| 精細許可權除錯 | /status、/permissions、shell 環境更透明 |
CLI 不是“不安全”:CLI 只是更接近工程現場。風險來自你給的許可權、當前目錄和命令環境,不來自“終端”本身。
4. Desktop:適合看得見的開發過程
Claude Code Desktop 的 Code tab 更像一個圖形化工作臺。
官方 Desktop 文件裡列了很多能力:parallel sessions、Git isolation、drag-and-drop pane layout、integrated terminal and file editor、side chats、computer use、Dispatch sessions、visual diff review、app previews、PR monitoring、connectors、enterprise configuration。
新手不需要一次記完,先記這 8 個判斷點:
- Visual diff review:想在圖形介面裡審改動。
- App preview:前端 / Web app 需要邊改邊看效果。
- Parallel sessions:多個任務並行,互不干擾。
- Integrated terminal:不想回終端看命令輸出。
- File editor:想直接開啟和編輯檔案。
- Side question:想問旁支問題但不打斷主任務。
- Dispatch:手機發任務,讓 Desktop 在你的機器上開 session。
- PR monitoring:看 PR 和 CI 狀態。
邊界也要記住:
- Desktop app 當前沒有 Linux 版;Linux 使用者用 CLI。
- Windows 首次開啟 Code tab 需要 Git for Windows。
- Desktop 的每個 conversation 是一個獨立 session,有自己的專案目錄、聊天曆史和程式碼改動。
- Desktop 適合視覺審查,不等於可以跳過許可權和 diff。
什麼時候用 Desktop:你要同時看聊天、diff、preview、terminal 和檔案時,Desktop 比純 CLI 舒服。
5. VS Code 和 JetBrains:減少上下文切換
IDE 外掛解決的是另一個問題:你已經在編輯器裡,不想頻繁切終端和瀏覽器。
VS Code 更適合:
- 看 inline diffs。
- 使用 integrated terminal。
- 讓 Claude 直接拿到當前檔案上下文。
- 在編輯器裡快速審查小改動。
JetBrains 更適合:
- IntelliJ、PyCharm、WebStorm、GoLand 等長期使用者。
- selection sharing,把你選中的程式碼傳給 Claude。
- 用 IDE diff viewer 審改動。
- 在 JetBrains terminal session 裡繼續 Claude Code 流程。
IDE 的取捨也很清楚:
- 審查改動更順手,但不如 CLI 暴露完整執行環境。
- 當前檔案上下文更自然,但複雜自動化仍要理解 CLI。
- 切換成本低,但遠端、指令碼、第三方供應商場景不一定最直接。
不要把 IDE 當唯一入口:IDE 很適合看和改,但真正理解 Claude Code 的許可權、認證、路徑、自動化,仍然要懂 CLI。
6. Web:任務在雲端繼續跑
Claude Code on the Web 適合長任務和雲端儲存庫任務。官方當前把它標為 research preview(研究預覽),適用於 Pro、Max、Team,以及部分 Enterprise 席位。
官方 Web 文件裡有幾個關鍵事實:
- 每個 session(會話)跑在 fresh Anthropic-managed VM(全新的 Anthropic 託管虛擬機器),不是你的本機環境。
- 儲存庫會被 clone 到雲端,commit 到 repo 的內容才可用。
- 本機使用者配置不會自動帶過去,user-level MCP、local secrets、未提交改動不在雲端。
.claude/settings.json、.mcp.json、.claude/skills/等 repo 檔案可用,所以團隊配置要提交進儲存庫。- 還沒有專用 secrets store,環境變數和 setup scripts 可被有許可權編輯環境的人看到。
這意味著 Web 很適合:
- 長時間重構。
- 後臺修 lint、補測試。
- 你離開電腦也要繼續跑的任務。
- 從 Slack、Mobile 或網頁發起的雲端 session。
不適合:
- 依賴你本機未提交檔案的任務。
- 依賴本機 private credentials 的任務。
- 需要本機 GUI、特定硬體、特殊內網環境的任務。
把雲端 session 拉回終端,用 Teleport:
claude --teleport或在已有 CLI session 裡:
/teleport注意 Teleport 要求:clean git state、同一個儲存庫、雲端分支已 push、同一個 Claude.ai 賬號。API key、Bedrock、Vertex AI、Foundry 認證不支援 Teleport。
Web 不是你的本機延長線:它是雲端新 VM。只有提交到儲存庫和配置到 cloud environment 的東西,才可靠存在。
7. Mobile、Remote Control 和 Dispatch
離開電腦後,官方提供幾種方式繼續工作。
最容易混淆的是 Remote Control 和 Dispatch:
- Remote Control:Claude 跑在你的本機 CLI 或 VS Code session,你從
claude.ai/code或 Claude mobile app 控制。適合接管正在跑的本機會話。 - Dispatch:Claude 跑在你的機器上的 Desktop session,由 Claude mobile app 發任務。適合從手機派一個新任務給 Desktop。
- Mobile cloud session(移動端雲會話):Claude 跑在 Anthropic cloud,由 Claude iOS / Android app 發起或監控雲端任務。
Remote Control 當前也是 research preview(研究預覽),對 Claude Code 版本有最低要求;具體版本號以官方 Remote Control 頁 當前說明為準(功能在快速迭代)。普通互動會話可以這樣啟動:
claude --remote-control也可以給 session 起名:
claude --remote-control "My Project"它不需要你機器開啟入站埠。官方說明是:本地 session 透過 HTTPS outbound 連線 Anthropic API,遠端瀏覽器或手機透過 Anthropic 伺服器路由訊息。
Remote Control 的邊界:
- 需要 Claude.ai OAuth full-scope login。
CLAUDE_CODE_OAUTH_TOKEN這種長期 token 不夠。- API key、Bedrock、Vertex AI、Foundry 不支援 Remote Control。
- Team / Enterprise 預設關閉,需要管理員在 Claude Code 管理設定裡開啟。
- 網路斷開太久,本地 session 會超時退出;官方文件給出的參考是大約 10 分鐘。
遠端控制不是雲端執行:Remote Control 只是從手機或瀏覽器控制你的本機 session。機器睡眠、斷網、目錄狀態異常,都會影響它。
8. Chrome、Slack、CI/CD 和 Code Review
整合層解決的是“讓 Claude Code 進入已有工作流”。
官方 platforms 頁面列的常見整合可以按場景理解:
- Chrome:控制已登入瀏覽器,適合測 Web app、填表、自動化沒有 API 的網站。
- GitHub Actions:在 CI 中執行 Claude,適合 PR review、issue triage、定時維護。
- GitLab CI/CD:在 GitLab 流水線中執行 Claude,適合 GitLab 專案自動化。
- Code Review:自動審查 PR,重點看邏輯錯誤、安全風險和迴歸。
- Slack:在頻道里
@Claude發起任務,適合從團隊討論直接生成 session / PR。 - MCP / connectors:接 Linear、Notion、Google Drive、內部 API,適合連線外部系統。
Slack 要特別注意許可權邊界:
- 需要 Claude Code on the Web enabled。
- 需要 GitHub 賬號連線到 Claude Code on the Web。
- 每個使用者用自己的 Claude account 和計劃額度。
- Claude 只響應它被邀請進的 channel。
- Slack direct messages(私信)不支援,只支援公開或私有 channel。
- Slack thread 和 channel context 會被用於理解任務,要只在可信頻道使用。
- 當前 Slack 整合只支援 GitHub 儲存庫。
CI/CD 也不要直接全自動放飛。以 GitHub Actions 為例,官方示例會把 Claude 用在 pull_request 上做 review,並限制 turns。團隊應該明確 token、許可權、儲存庫範圍和輸出位置。
團隊整合原則:越靠近公共頻道、CI、PR 和生產流程,越要把許可權、審查和日誌寫清楚。整合不是繞過審查,而是把審查前移。
9. 怎麼做選擇
把前八節壓成一張決策樹:
flowchart TD
Q1{第一次學 Claude Code<br/>或日常本機專案?}
Q1 -->|是| CLI[CLI]
Q1 -->|否| Q2{需要視覺 diff 或<br/>app preview?}
Q2 -->|是| Desktop[Desktop 或 IDE + preview]
Q2 -->|否| Q3{要離開電腦<br/>繼續跑長任務?}
Q3 -->|是| Web[Web / Mobile]
Q3 -->|否| Q4{團隊從 Slack / PR / CI<br/>觸發任務?}
Q4 -->|是| Team[Slack / GitHub Actions / Code Review]
Q4 -->|否| CLI
style CLI fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Desktop fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
style Web fill:#dcfce7,stroke:#22c55e,stroke-width:2px
style Team fill:#fce7f3,stroke:#ec4899,stroke-width:2px
實用選擇可以先按這個順序判斷:
- 第一次學習 Claude Code:CLI。
- 日常本機專案,喜歡終端:CLI。
- 前端改動需要看頁面:Desktop 或 IDE + preview。
- 不想離開 VS Code:VS Code。
- JetBrains 重度使用者:JetBrains。
- 長任務,離開電腦也要繼續跑:Web。
- 手機上派任務給自己電腦:Dispatch + Desktop。
- 手機上接管正在跑的本機任務:Remote Control。
- 團隊從 Slack 討論轉任務:Slack + Web。
- PR 自動審查:Code Review / GitHub Actions。
- 連線外部系統:MCP / connectors。
更簡單的版本:
| 現在要做什麼 | 直接選 |
|---|---|
| 學習和本機開發 | CLI |
| 視覺審查和預覽 | Desktop |
| 不想離開編輯器 | VS Code / JetBrains |
| 離開電腦也要繼續 | Web / Mobile |
| 團隊觸發和自動化 | Slack / CI / Code Review |
10. 本章自檢
試著用自己的話回答:
- 為什麼平臺選擇的核心不是“哪個最強”,而是“Agent 跑在哪裡”?對應 §1。
- CLI、Desktop、IDE、Web 四者的主要取捨是什麼?對應 §2-§6。
- 為什麼 Web session 不能直接訪問你本機的 user-level MCP 和未提交檔案?對應 §6。
- Remote Control 和 Dispatch 的區別是什麼?對應 §7。
- Slack 和 CI/CD 整合為什麼更需要許可權和審查邊界?對應 §8。
過關標準:你能為一個真實任務選出入口,並能說明專案在哪裡、誰審結果、任務是否需要離線繼續、哪些憑據和許可權會被用到。
本篇術語速查表
- Surface:介面,CLI、Desktop、IDE、Web、Mobile 這類互動介面。
- CLI:命令列入口,最完整、最適合學習和自動化的本地入口。
- Agent SDK:智慧體開發包,用來把 Claude Code 能力接入指令碼或自動化系統。
- Computer use:電腦控制,讓 Claude 在支援的平臺上操作本機應用或瀏覽器。
- Desktop:桌面應用,圖形化 Code tab,適合 diff、preview、並行 session。
- IDE extension:編輯器擴充套件,VS Code / JetBrains 內的 Claude Code 入口。
- Web session:雲端會話,跑在 Anthropic-managed VM 的 Claude Code session。
- Teleport:傳送會話,把雲端 session 拉回本地 CLI 的機制。
- Remote Control:遠端控制,從 Web 或 mobile 控制本機 CLI / VS Code session。
- Dispatch:派發任務,從手機把任務發給 Desktop 建立 session。
- Channels:頻道觸發,從 Telegram、Discord 或自建服務推事件進 CLI session。
- Code Review:程式碼審查整合,自動審查 PR 的 Claude Code 整合。
- Connectors:聯結器,接入 Linear、Notion、Google Drive 等外部系統。
官方來源
- Platforms and integrations
- Use Claude Code Desktop
- Claude Code on the web
- Remote Control
- Claude Code in Slack
- Claude Code GitHub Actions
接下來去哪
配置 Claude Code
選好入口後,下一步是理解 settings scope:哪些配置屬於個人,哪些屬於專案,哪些該由管理員下發。
登入與認證(上一篇)
如果 Remote Control、Web 或 Slack 不能用,先回到認證篇檢查當前生效憑據。
深度理解:Claude Code 是什麼
入口選擇背後的底層邏輯,是 Claude Code 作為本地程式設計 Agent 的工作方式。
如果只記一個判斷:先從 CLI 建立完整心智模型,再按任務需要疊加 Desktop、IDE、Web、Mobile 和團隊整合;入口可以混用,但上下文、憑據和執行位置必須分清。