# 影片筆記：Claude Code 新手教程：3步安装配置，直接跑通第一个任务

## 一句話總結

本影片教學如何透過第三方工具 **CC-Switch** 輔助，在 Mac 與 Windows 系統上安裝並配置 **Cloud Code**，涵蓋了從下載安裝、路由配置到大模型 API（官方或中轉站）接入的完整流程，最終透過讓 AI 在桌面寫詩並刪除檔案來驗證功能。

## 核心重點

*   **核心工具**：強調使用第三方工具 **CC-Switch** 來輔助部署 Cloud Code，特別是針對網路環境較差或無網路環境的使用者。
*   **安裝差異**：Mac 系統安裝相對簡單，Windows 系統則強烈依賴網路環境（需具備科學上網條件）才能完成安裝。
*   **模型接入**：提供兩種接入大模型的方式：
    1.  **官方 API**：穩定但僅限自家模型（如 Deepseek）。
    2.  **中轉站 API**：靈活、模型選擇多、成本可能較低，但穩定性取決於中轉站。
*   **驗證方式**：透過讓 AI 在桌面「寫詩」並「刪除」該檔案，來確認 Cloud Code 具備讀取文件、理解需求及執行操作的能力。

## 詳細大綱

### 一、 前置準備與下載
1.  **下載 CC-Switch 安裝包**
    *   有網路環境：透過 Google 搜尋 `CCSWITCH`，進入 GitHub 找到 `RAINIS` 發布頁面，下載對應系統安裝包（Mac 選 `.dmg`，Windows 選 `.msi`）。
    *   無網路環境：下載包將放置於影片簡介或雲端硬碟。
2.  **下載 Cloud Code Desktop 安裝包**
    *   搜尋 `Cloud Code Desktop`，進入官網 `cloud.com` 下載對應系統版本。
    *   **注意**：Windows 版本必須具備網路環境才能安裝；Mac 版本則無此限制。

### 二、 Mac 系統部署教學
1.  **配置 CC-Switch**
    *   開啟 CC-Switch 設定。
    *   取消勾選其他選項，僅保留 `Cloud Desktop`。
    *   **關鍵步驟**：務必開啟「跳過 Cloud Code 初次安裝確認」。
    *   開啟「軟路由」。
2.  **接入大模型（兩種方式）**
    *   **方式 A：官方 API (以 Deepseek 為例)**
        *   在 Deepseek 官網 API 開放平台創建 API Key。
        *   在 CC-Switch 中添加 Deepseek，填入 API Key。
        *   點擊獲取模型列表並添加，最後點擊「啟用」。
    *   **方式 B：中轉站 API (以 Cloud 模型為例)**
        *   準備中轉站的「請求地址 (Base URL)」與「API Key」。
        *   在 CC-Switch 中選擇「自定義」添加。
        *   進入帳號控制台創建令牌 (API Key)，選擇模型（如 Cloud）。
        *   複製 API Key 與請求地址至 CC-Switch，獲取模型列表並添加，最後點擊「啟用」。
3.  **驗證功能**
    *   開啟 Cloud Code，要求其在桌面寫一首詩。
    *   確認檔案生成後，要求刪除，確認功能正常。

### 三、 Windows 系統部署教學
1.  **安裝軟體**
    *   安裝 CC-Switch 與 Cloud Code Desktop（一路下一步）。
    *   **前提條件**：Windows 必須具備科學網路環境。
2.  **配置 CC-Switch**
    *   開啟設定，僅保留 `Cloud Code Desktop`。
    *   **關鍵步驟**：務必點擊「跳過 Cloud Code 初次安裝確認」。
    *   點擊「開啟本地路由」（若未開啟，Cloud Code 可能無法使用）。
3.  **接入大模型**
    *   **官方 API (Deepseek)**：流程同 Mac，於 Deepseek 官網獲取 Key 並填入 CC-Switch。
    *   **中轉站 API (GPT/Cloud 等)**：
        *   獲取中轉站的「伺服器訪問地址 (Base URL)」與「API Key」。
        *   在 CC-Switch 自定義配置中填入資訊。
        *   獲取模型列表並添加，點擊啟用。
4.  **啟動與驗證**
    *   在搜尋中找到 Cloud Code 並固定至開始畫面。
    *   若桌面讀取有誤，需明確告知 AI 桌面路徑。
    *   要求 AI 在桌面建立 TXT 檔案並寫入內容（如詩歌），確認成功。

### 四、 總結回顧
1.  下載並安裝 CC-Switch 與 Cloud Code。
2.  CC-Switch 設定：僅保留 Cloud Code 選項、開啟「跳過初次安裝確認」、開啟軟路由/本地路由。
3.  添加大模型（官方或中轉站），獲取 API Key 並啟用。
4.  開啟 Cloud Code 進行測試。

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

*   **Cloud Code** (或 Cloud Code Desktop)
*   **CC-Switch** (或 CCSWITCH)
*   **GitHub**
*   **RAINIS** (發布者名稱)
*   **cloud.com** (官網連結)
*   **Deepseek** (大模型)
*   **Deepseek with Flash** (模型版本)
*   **小米** (提及的模型/品牌)
*   **質樸的 GLM** (提及的模型，原文聽寫)
*   **GPT** (大模型)
*   **Cloud** (中轉站模型名稱)
*   **5.5** (疑似模型版本號，原文聽寫)
*   **Ops4.6** (疑似模型版本號，原文聽寫)
*   **Slot4.6** (疑似模型版本號，原文聽寫)
*   **Mark** (疑似檔案格式或名稱，原文聽寫)
*   **TXT** (檔案格式)

## 操作流程整理

### Mac 系統
1.  **下載**：搜尋 `CCSWITCH` 至 GitHub 下載 `RAINIS` 發布的 `.dmg` 安裝包；搜尋 `Cloud Code Desktop` 至 `cloud.com` 下載。
2.  **配置 CC-Switch**：
    *   開啟設定，僅保留 `Cloud Desktop`。
    *   開啟「跳過 Cloud Code 初次安裝確認」。
    *   開啟「軟路由」。
3.  **接入模型**：
    *   **官方**：在 Deepseek 官網獲取 API Key，填入 CC-Switch 並啟用。
    *   **中轉站**：獲取 Base URL 與 API Key，在 CC-Switch 自定義中添加並啟用。
4.  **驗證**：開啟 Cloud Code，指令在桌面寫詩，確認檔案後指令刪除。

### Windows 系統
1.  **下載**：搜尋 `CCSWITCH` 至 GitHub 下載 `RAINIS` 發布的 `.msi` 安裝包；搜尋 `Cloud Code Desktop` 至 `cloud.com` 下載（需具備網路環境）。
2.  **安裝**：安裝 CC-Switch 與 Cloud Code Desktop。
3.  **配置 CC-Switch**：
    *   開啟設定，僅保留 `Cloud Code Desktop`。
    *   點擊「跳過 Cloud Code 初次安裝確認」。
    *   點擊「開啟本地路由」。
4.  **接入模型**：
    *   **官方**：同 Mac，於 Deepseek 官網獲取 Key 填入 CC-Switch。
    *   **中轉站**：獲取 Base URL 與 API Key，在 CC-Switch 自定義中添加並啟用。
5.  **驗證**：搜尋啟動 Cloud Code，若桌面讀取有誤需告知路徑，指令在桌面建立 TXT 檔案寫入內容（如詩歌）。

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

*   **網路依賴**：Windows 版本的 Cloud Code 安裝強烈依賴網路環境（需具備科學上網條件）；Mac 版本相對無此限制。
*   **路由配置**：CC-Switch 必須開啟「軟路由」或「本地路由」，否則 Cloud Code 可能無法使用。
*   **初次安裝確認**：務必開啟「跳過 Cloud Code 初次安裝確認」，否則可能影響使用。
*   **中轉站穩定性**：使用中轉站 API 時，穩定性取決於中轉站本身，雖靈活且成本可能較低，但存在不穩定風險。
*   **桌面路徑識別**：Windows 系統下，若 AI 無法正確讀取桌面，需明確告知 AI 桌面路徑。

## 逐字稿辨識疑點

*   **cloud.com**：Cloud Code 的官方網址通常為 `aistudio.google.com` 或相關代碼倉庫，此處逐字稿明確提及 `cloud.com`，保留原樣。
*   **RAINIS**：GitHub 上的發布者名稱，聽寫可能為 `Rainis` 或其他拼寫，保留原樣。
*   **質樸的 GLM**：通常指「智譜 GLM」或類似名稱，逐字稿聽寫為「質樸的 GLM」，保留原樣。
*   **5.5**、**Ops4.6**、**Slot4.6**：這些看起來像是模型版本號（如 GPT-4o, Claude 3.5 等），但逐字稿聽寫為這些名稱，保留原樣。
*   **Mark**：要求寫入的檔案名稱或格式，逐字稿聽寫為「Mark」，保留原樣。
*   **Always Alone**：在確認操作權限時，逐字稿聽寫為「Always Alone」，通常此類選項為「Always Allow」，保留原樣。
*   **吉尼挂拉**：回顧步驟時的口語或聽寫錯誤，保留原樣。
*   **分阻力排一半**：關於計費方式的描述，聽寫不清，保留原樣。
*   **得愛恨情愁**：詩歌名稱或內容，保留原樣。
*   **Windows.msi**：Windows 安裝包格式，保留原樣。
*   **.dmg**：Mac 安裝包格式，保留原樣。

## 可延伸追問

*   CC-Switch 的具體 GitHub 倉庫連結為何？
*   中轉站 API 的推薦供應商有哪些？
*   若 Windows 系統無法具備科學上網條件，是否有替代安裝方案？
*   Cloud Code 的「軟路由」與「本地路由」具體技術原理為何？
*   如何確保中轉站 API 的 API Key 安全性？