# 影片筆記：Claude Code安装教程：CLI、桌面端、CC Switch接入DeepSeek、VS Code配置

## 一句話總結

本影片詳細講解了如何在 Windows 系統上安裝並配置 **Cloud Code**（CLI 與桌面端），透過安裝 **CC Switch** 中介工具，將 API 路由指向第三方模型（如 Deepseek），並在 VS Code 中實現整合與對話功能。

## 核心重點

1.  **環境準備**：強調中國大陸用戶需確保網路可訪問國外網站，並依序安裝 Node.js、Git 及 Cloud Code CLI。
2.  **CLI 配置**：透過修改 `cloud.json` 配置文件，將官方 API 路由至第三方 API（如 Deepseek）。
3.  **中介工具 CC Switch**：安裝並配置 CC Switch，用於管理第三方 API Key 及路由，實現對 Deepseek 模型的調用。
4.  **VS Code 整合**：安裝 VS Code 及 Cloud Code 插件，實現 IDE 內的對話功能。
5.  **桌面端配置**：安裝 Cloud Code 桌面版，啟用開發平台，配置路由至 CC Switch，並解決 Windows 虛擬機平台相關功能缺失問題。

## 詳細大綱

### 一、 前置準備與基礎環境安裝
1.  **網路檢查**：確認可訪問國外網站（針對中國大陸用戶）。
2.  **安裝 Node.js**：
    *   訪問指定網站下載安裝檔。
    *   執行安裝程序（同意協議、預設路徑、完成）。
3.  **安裝 Git**：
    *   訪問指定網站下載。
    *   Windows 用戶點擊下載按鈕（ARM 處理器點擊另一按鈕）。
    *   執行安裝程序（同意協議、預設路徑、完成）。

### 二、 Cloud Code CLI 安裝與環境變數配置
1.  **安裝 Cloud Code CLI**：
    *   訪問 Cloud Code 官方網站獲取安裝命令。
    *   以管理員身份打開 PowerShell。
    *   複製並執行安裝命令。
2.  **配置環境變數**：
    *   搜尋並開啟「環境變數」。
    *   編輯 `Path` 變數。
    *   找到安裝路徑下的 `bin` 資料夾（通常在 `C:\Users\用戶名\AppData\Local\...`）。
    *   將該路徑新增至環境變數中。
3.  **驗證安裝**：
    *   打開 CMD，輸入 `cloud` 測試是否識別。

### 三、 Cloud Code CLI 路由配置（繞過官方 API）
1.  **修改配置文件**：
    *   進入 `C:\Users\用戶名\.cloud` 資料夾。
    *   找到 `cloud.json` 檔案，使用記事本編輯。
    *   在第二行添加特定配置語句（注意縮排與逗號），以繞過官方 API 限制。
2.  **測試 CLI 功能**：
    *   在 CMD 輸入 `cloud`，確認信任當前目錄。
    *   確認顯示的模型為 Deepseek v4 pro。
    *   測試回覆功能是否正常。

### 四、 安裝與配置 CC Switch（API 路由中介）
1.  **下載 CC Switch**：
    *   訪問指定示例網頁，下載 Windows 版本的 CC Switch 安裝檔。
    *   執行安裝（同意協議、預設路徑、完成）。
2.  **配置 Deepseek API**：
    *   訪問 Deepseek API 開放平台並登錄。
    *   充值少量金額（如 1-20 元）。
    *   創建 API Key，並**務必複製保存 API 地址**（否則下次不可見）。
3.  **在 CC Switch 中配置**：
    *   打開 CC Switch，點擊加號新增配置。
    *   選擇 Deepseek，輸入剛才獲取的 API 地址。
    *   若需使用長上下文（100萬），勾選相關選項。
    *   點擊「添加」，進行「模型測試」確認正常後，點擊「啟用」。

### 五、 VS Code 整合 Cloud Code
1.  **安裝 VS Code**：
    *   下載並安裝 VS Code。
    *   （可選）安裝中文語言包並重啟。
2.  **安裝 Cloud Code 插件**：
    *   在 VS Code 擴展市場搜尋「Cloud Code」。
    *   安裝官方出品的插件。
3.  **測試對話功能**：
    *   點擊 VS Code 左側 Cloud Code 圖標。
    *   打開對話視窗，測試回覆是否正常。

### 六、 Cloud Code 桌面端（GUI）配置
1.  **安裝桌面端**：
    *   訪問指定地址下載桌面端安裝檔。
    *   執行安裝並打開。
2.  **啟用開發平台**：
    *   點擊左上角選單 -> Help -> 開啟開發平台（Enable）。
3.  **配置 API 與路由**：
    *   在開發平台介面中，點擊加號新增配置。
    *   選擇 Deepseek，輸入 API Key。
    *   測試獲取模型（確認 Deepseek v4 Flash/Pro 可用）。
    *   勾選長上下文選項，點擊「添加」。
    *   進入「設置」->「路由」，開啟「本地路由」。
    *   啟用 Deepseek，確認捕獲到 CC Switch。
4.  **解決虛擬機平台問題**：
    *   若出現錯誤，需開啟 Windows 功能。
    *   勾選以下三項：
        1.  虛擬機平台
        2.  適用於 Linux 的 Windows 子系統
        3.  Windows 虛擬機監控程序平台
    *   點擊確定並立即重啟電腦。
5.  **最終驗證**：
    *   重啟後打開 CC Switch 與 Cloud Code 桌面端。
    *   確認模型可正常切換與使用。

## 工具 / 模型 / 名詞整理

*   **軟體/工具**：
    *   Cloud Code (CLI 版本)
    *   Cloud Code (桌面端/GUI 版本)
    *   Node.js
    *   Git
    *   CC Switch
    *   VS Code (Visual Studio Code)
    *   PowerShell
    *   CMD (命令提示字元)
    *   記事本 (Notepad)
    *   Deepseek API 開放平台
*   **模型/技術**：
    *   Deepseek v4 pro
    *   Deepseek v4 Flash
    *   ARM 處理器
    *   Windows 虛擬機平台
    *   適用於 Linux 的 Windows 子系統
    *   Windows 虛擬機監控程序平台

## 操作流程整理

1.  **基礎環境搭建**：
    *   確認網路可訪問國外。
    *   安裝 Node.js。
    *   安裝 Git。
    *   安裝 Cloud Code CLI 並配置環境變數（Path），驗證 `cloud` 命令。
2.  **CLI 路由配置**：
    *   編輯 `C:\Users\用戶名\.cloud\cloud.json`。
    *   添加配置語句繞過官方 API。
    *   測試 CLI 是否指向 Deepseek v4 pro。
3.  **中介工具 CC Switch 配置**：
    *   下載並安裝 CC Switch。
    *   在 Deepseek API 開放平台註冊、充值、創建 API Key 並複製 API 地址。
    *   在 CC Switch 中添加 Deepseek 配置，輸入 API 地址，測試並啟用。
4.  **VS Code 整合**：
    *   安裝 VS Code 及 Cloud Code 插件。
    *   測試對話視窗功能。
5.  **桌面端配置**：
    *   安裝 Cloud Code 桌面端。
    *   啟用開發平台（Help -> Enable）。
    *   在開發平台配置 Deepseek API Key。
    *   設置路由為「本地路由」，啟用 Deepseek 並確認捕獲 CC Switch。
    *   若遇錯誤，開啟 Windows 虛擬機相關功能並重啟。
    *   最終驗證模型切換與使用。

## 值得注意的限制或風險

1.  **網路環境限制**：影片特別強調中國大陸用戶需確保網路環境可訪問國外網站，否則可能無法正常下載或配置。
2.  **API 地址保存風險**：在 Deepseek API 開放平台創建 API Key 時，務必複製保存 API 地址，否則下次可能不可見。
3.  **系統功能依賴**：Cloud Code 桌面端在 Windows 上運行可能需要特定的虛擬機平台功能（虛擬機平台、適用於 Linux 的 Windows 子系統、Windows 虛擬機監控程序平台），若未開啟可能會出現錯誤，需重啟電腦。
4.  **長上下文配置**：使用長上下文（100萬）需在 CC Switch 中勾選相關選項，否則可能無法生效。

## 逐字稿辨識疑點

*   **667s**：逐字稿中提到的下載 Node.js 的網站地址，聽起來像是「667s」或類似發音，實際應為 Node.js 官方網站或其他鏡像站，需查證。
*   **load.js / load.js**：逐字稿中將 Node.js 口誤稱為「load.js」或「load.js」，需查證。
*   **bit**：逐字稿中將 Git 口誤稱為「bit」，需查證。
*   **Gate**：逐字稿中將 Git 口誤稱為「Gate」，需查證。
*   **PowerShop / PowerShare**：逐字稿中將 PowerShell 口誤稱為「PowerShop」或「PowerShare」，需查證。
*   **接生文件 / 教驗**：逐字稿中將 `cloud.json` 配置文件口誤稱為「接生文件」或「教驗」，需查證。
*   **焊化的**：逐字稿中將「漢化的」口誤為「焊化的」，需查證。
*   **簽例子**：逐字稿中將「關鍵字」口誤為「簽例子」，需查證。
*   **Deepseq**：逐字稿中將 Deepseek 口誤為「Deepseq」，需查證。
*   **API case**：逐字稿中將 API Key 口誤為「API case」，需查證。
*   **em 的復權框**：逐字稿中將「上下文」口誤為「em 的復權框」，需查證。
*   **OS code**：逐字稿中將 VS Code 口誤為「OS code」，需查證。
*   **虛定機平台**：逐字稿中將「虛擬機平台」口誤為「虛定機平台」，需查證。
*   **可可可可**：逐字稿中將「CC Switch」口誤為「可可可可」，需查證。
*   **運氣**：逐字稿中將「路由」口誤為「運氣」，需查證。

## 可延伸追問

1.  CC Switch 的具體下載網址為何？
2.  `cloud.json` 配置文件中的具體配置語句內容為何？
3.  Deepseek API 開放平台的具體註冊與充值流程細節？
4.  Cloud Code 桌面端在啟用開發平台後，具體的界面操作步驟？
5.  Windows 虛擬機平台相關功能開啟後，對系統性能是否有影響？