AI 程式設計教程中文版
官方教程中文版入門與安裝

選擇平臺與整合

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
需要視覺化預覽、並行會話、圖形化 diffDesktop
長任務要離開電腦繼續跑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行內差異、整合終端、檔案上下文
JetBrainsIntelliJ、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. 本章自檢

試著用自己的話回答:

  1. 為什麼平臺選擇的核心不是“哪個最強”,而是“Agent 跑在哪裡”?對應 §1。
  2. CLI、Desktop、IDE、Web 四者的主要取捨是什麼?對應 §2-§6。
  3. 為什麼 Web session 不能直接訪問你本機的 user-level MCP 和未提交檔案?對應 §6。
  4. Remote Control 和 Dispatch 的區別是什麼?對應 §7。
  5. 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 等外部系統。

官方來源

接下來去哪

如果只記一個判斷:先從 CLI 建立完整心智模型,再按任務需要疊加 Desktop、IDE、Web、Mobile 和團隊整合;入口可以混用,但上下文、憑據和執行位置必須分清。

本頁目錄