全程使用桌面版應用程式，有完整圖形介面，不需要打指令。照這份文件走一次大約 15 分鐘。做到哪一步卡住，把那一步的畫面截圖給助教，不要跳過往下做。
Claude 免費方案不能使用 Code 功能。你必須有 Claude Pro、Max、Team 或 Enterprise 訂閱。若課程由公司統一開通帳號，請先確認你已收到帳號，並且能登入 claude.ai。
| 項目 | 需求 |
|---|---|
| 作業系統 | macOS 13.0 以上 ／ Windows 10 (1809) 以上 |
| 記憶體 | 4 GB 以上 |
| 處理器 | x64 或 ARM64（Apple M 系列屬於 ARM64，完全支援） |
| 網路 | 需要連網。公司內網若有防火牆或 Proxy，請先向 IT 確認可連到 claude.ai 與 api.anthropic.com |
不需要安裝 Node.js 或任何開發工具，不需要有 GitHub 帳號，不需要會寫程式，也不需要使用終端機。桌面版已經包含全部所需的東西。
點選你的系統下載安裝檔，下載完打開它，照畫面指示安裝即可。
Windows ARM64（如 Surface Pro X、Snapdragon 機種）請下載 ARM64 安裝檔。不確定自己是哪一種的話，先試 x64 版本即可。
Linux（Ubuntu／Debian，Beta）請參考官方的 Linux 安裝說明，使用 apt 或 .deb 安裝。
打開下載的 .dmg 檔，把 Claude 圖示拖進「應用程式」資料夾，然後從「應用程式」或 Launchpad 啟動。
首次開啟若出現安全性提示，在「系統設定 → 隱私權與安全性」按「仍要打開」。
執行下載的安裝檔，一路按「下一步」完成，然後從開始功能表啟動 Claude。
不需要系統管理員權限。若 SmartScreen 攔截，點「其他資訊 → 仍要執行」。
Windows 上必須先安裝 Git，本機專案功能才能運作。這是官方要求，不是選配。
到 git-scm.com/downloads/win 下載安裝，全程按預設值「下一步」即可，不用更改任何選項。裝完請把 Claude 桌面版關掉重開。
Mac 通常已內建 Git，不需要另外安裝。
要求你上網登入：完成登入後把應用程式整個關掉重開。
出現 403 錯誤：先登出再重新登入；仍不行請截圖給助教，多半是帳號權限還沒開通。
| 分頁 | 做什麼 | 課程會用嗎 |
|---|---|---|
| Chat | 一般對話，不會存取你的檔案，跟 claude.ai 網頁版一樣 | 偶爾 |
| Cowork | 背景自動代理，在獨立的虛擬環境裡自己跑任務 | 課程後段 |
| Code | 互動式協作，可直接存取你的本機檔案，每個改動你逐一審核 | 主要使用 |
在 Code 分頁裡，先選執行環境，再選資料夾。
Cloud：在 Anthropic 的雲端執行，即使關掉應用程式也會繼續跑。
SSH：連到遠端主機執行，例如公司的伺服器或雲端主機。
WSL（Windows）：在 WSL 2 的 Linux 環境裡執行。
這三種在課堂上都不會用到，選 Local 就好。
在桌面建一個叫 claude-demo 的空資料夾，裡面放兩三份去識別化的工作文件（拿掉個資與敏感數字）。課堂實作就用它，安全又不會影響正式檔案。
先自己試一次，課堂上就不會手忙腳亂。
「幫我改一下」→ 結果通常不是你要的。
「把這份會議記錄整理成三個決議事項，每項標出負責人與期限，用表格呈現」→ 一次到位。
在送出按鈕旁邊的下拉選單切換。差別在於思考深度、速度與成本，不是「會不會中文」——全部都能處理中文。
| 模型 | 定位 | 什麼時候用 | 脈絡長度 |
|---|---|---|---|
| Opus 5 | 複雜推理與代理式工作 | 多檔案改動、大型任務、需要規劃的工作。課堂預設 | 1M |
| Sonnet 5 | 速度與智慧的平衡 | 日常撰寫、一般問答、量大的例行工作 | 1M |
| Haiku 4.5 | 最快、最便宜 | 簡單分類、格式轉換、要求即時回應的小任務 | 200K |
| Fable 5 | 能力最強 | 跨越整個工作階段的長任務、疑難排解、架構決策 | 1M |
脈絡長度＝一次對話能容納的資訊量。1M 約等於數十萬字的中文內容。各模型費率見第 14 節。
多半是應用程式版本太舊。桌面版會自動更新，但你可以把它完全關掉再重開強制檢查一次。仍看不到請告訴助教。
Claude 要改檔案或執行動作之前，會停下來問你。權限模式決定它多常問。這是課堂上最常被問到的觀念。
點輸入框旁邊的模式選單切換。預設是 Manual。
| 模式 | 行為 | 適合 |
|---|---|---|
| Manual 手動 | 每個檔案改動、每個指令都會先問你 | 預設值，建議新手停在這裡 |
| Accept edits 自動接受編輯 | 檔案改動自動套用，不再逐一詢問 | 你會事後用差異檢視一次看完的時候 |
| Plan 計畫模式 | 完全不動你的檔案，只研究並寫出一份計畫給你看 | 大改動之前，先讓它想清楚再動手 |
遇到比較大的任務時，先切到 Plan。Claude 會先讀資料、想清楚，然後給你一份計畫，你確認後它才開始動手。計畫出來後你可以同意執行、或告訴它哪裡要改再重新規劃。
桌面版設定裡有跳過權限確認的選項。課堂練習請不要開啟——它會關掉所有安全確認，而這是在你自己的電腦上執行，風險很高。
這一節帶你認識 Code 分頁的介面，以及三個課程會用到的功能：左側工作階段列表、連接外部工具（MCP）、使用技能。下面的示意圖標出各個位置。
用 Ctrl+Tab 在工作階段之間切換。按住 ⌘（Windows 為 Ctrl）點側邊欄的另一個階段，畫面會分割成兩欄並排顯示；⌘\ 關掉聚焦的那一欄。
如果專案是 Git 版本庫，每個工作階段會拿到自己獨立的副本，彼此的改動不會互相干擾。做完了就滑到該階段上按封存圖示收掉。
要讓 Claude 連上 Google 日曆、Slack、GitHub、Linear、Notion 這類外部服務，用連接器（Connectors）。連接器就是有圖形設定流程的 MCP 伺服器，不需要編輯設定檔。
側邊欄下方的 Customize 可以在同一個地方管理連接器、技能與外掛。
清單裡沒有的服務才需要手動加 MCP 伺服器設定檔，課程不會用到這種做法。＋ 按鈕在雲端與 WSL 工作階段不會出現，這也是課程統一用 Local 的原因之一。
技能是預先寫好的一包做事流程，例如產出 Excel、簡報、PDF 的專用流程。Claude 判斷任務相關時會自動載入，你也可以主動指定。
/，或點 ＋ → Slash commands。個人技能放在 ~/.claude/skills/，本機工作階段會自動讀到。專案專屬的技能則放在專案資料夾裡，跟著程式碼一起走。
要安裝別人做好的整包功能，用 ＋ → Plugins → Add plugin 瀏覽外掛市集。外掛一次會帶進技能、代理、MCP 伺服器等多種東西。
Code 分頁由多個窗格組成：對話、差異、瀏覽器、終端機、檔案、計畫、任務。拖曳窗格標頭可以重新排列，從工具列的 Views 選單開啟其他窗格。
| 要做什麼 | 怎麼做 |
|---|---|
| 把某個檔案帶進對話 | 輸入 @檔名，或直接把檔案拖進輸入框 |
| 附加圖片或 PDF | 點迴紋針按鈕 |
| 看它改了什麼 | 點對話裡的 +12 -1 標記開啟差異檢視，可在特定行留言請它修正 |
| 請它自我檢查 | 點 Review code |
| 打開檔案編輯 | 點對話裡的檔案路徑，會在檔案窗格開啟，改完按 Save |
| 調整顯示詳細程度 | 送出鍵旁的 Transcript view 下拉：Normal／Verbose／Summary |
| 中斷它 | 按停止鈕，或按 Esc |
Windows 請把 ⌘ 換成 Ctrl。
| 快捷鍵 | 做什麼 |
|---|---|
| ⌘/ | 列出所有快捷鍵 |
| ⌘N | 開新工作階段 |
| Ctrl+Tab | 切換到下一個工作階段 |
| Esc | 中斷 Claude 目前的動作 |
| ⌘⇧D | 開關差異窗格 |
| ⌘⇧M | 開啟權限模式選單 |
| ⌘⇧I | 開啟模型選單 |
| ⌘; | 開啟側邊提問（不干擾主對話） |
網路上的教學常提到用 Shift+Tab 切換權限模式——那是指令列版本的操作，桌面版不適用。桌面版請點模式選單，或按 ⌘⇧M。
在輸入框打 / 就會列出全部，不需要背。以下是課堂常用的幾個：
| 指令 | 做什麼 |
|---|---|
/clear | 清空對話重新開始（脈絡滿了或要換題目時用） |
/context | 看目前脈絡用掉多少 |
/compact | 把對話濃縮成摘要，騰出脈絡空間 |
/init | 為目前資料夾建立 CLAUDE.md 說明檔 |
/rewind | 把檔案與對話一起回捲到先前的檢查點 |
/usage | 查看用量 |
/help | 列出所有可用指令 |
課堂上會反覆出現的詞。看不懂沒關係，先掃過一遍有印象就好。
/compact 或 /clear。/ 開頭的指令，例如 /clear。打一個斜線就會跳出清單。/init 建立。/rewind 把檔案和對話一起退回去。先自己對照一次，還是不行再找助教。
| 狀況 | 原因與處理 |
|---|---|
| 安裝檔下載不了、或下載到一半失敗 | 多半是公司 VPN 或防火牆擋掉。先斷開 VPN 再下載一次。仍不行請回報課程窗口，我們協助處理。 |
| Mac 說「無法打開，因為無法驗證開發者」 | 到系統設定 → 隱私權與安全性，在下方找到 Claude 的提示，按「仍要打開」。 |
| Windows 出現 SmartScreen 藍色警告 | 點「其他資訊」→「仍要執行」。這是新安裝檔的正常提示。 |
| 點 Code 分頁被要求升級方案 | 帳號沒有 Code 權限。確認你登入的是公司開通的帳號，不是自己的免費帳號。 |
| 點 Code 分頁出現 403 錯誤 | 先登出再重新登入，並把應用程式完全關掉重開。仍不行請截圖回報。 |
| Windows：選了資料夾但本機工作階段起不來 | 沒有安裝 Git。到 git-scm.com/downloads/win 安裝後，把 Claude 關掉重開。 |
| Claude 說看不到我的檔案 | 你選的資料夾不對，或檔案在該資料夾之外。重新用 Select folder 選正確的位置。 |
| 回應變慢、或說脈絡快滿了 | 對話太長。用 /compact 濃縮，或 /clear 重開一段新對話。 |
| 它改壞了我的檔案 | 用 /rewind 回捲到先前的檢查點。下次記得停在 Manual 模式逐項審核。 |
把應用程式完全關掉再重開。安裝與登入類的問題有很高比例靠這一步就解決。仍不行就截圖給助教，會比用文字描述症狀快得多。
上課前請逐項確認。全部打勾代表你已經準備好了。
請在開課前一天回報給課程窗口，附上卡住那一步的截圖。不要留到當天早上——現場排解會佔用你自己的上課時間。
現場最常見的卡點、判斷路徑，以及 Git 安裝問題的指令對照。
請全班同時做兩件事：一、打開 Claude 桌面版點進 Code 分頁。二、用 Select folder 選到自己的練習資料夾。能走完這兩步的人就沒問題，只處理走不完的人。
| 症狀 | 先看什麼 | 最可能的原因 |
|---|---|---|
| Code 分頁要求升級 | 請他念出登入的信箱 | 用自己的免費帳號登入，不是公司開通的那個 |
| Windows：選了資料夾但起不來 | 問他有沒有裝 Git | 沒裝 Git，或裝了但沒重開 Claude |
| 下載或安裝失敗 | 問他有沒有開 VPN | 公司 VPN／Proxy 擋掉下載 |
| Mac 打不開應用程式 | 系統設定 → 隱私權與安全性 | Gatekeeper 攔截，按「仍要打開」 |
| Claude 讀不到檔案 | 看他選的工作資料夾 | 選錯資料夾，或檔案放在資料夾之外 |
| 一直被問要不要同意 | 看模式選單 | 在 Manual 模式，這是正常的；視情況引導切到 Accept edits |
Windows 上 Git 是必要條件，最常出問題。下面的指令由助教代為執行即可，不需要要求學員自己打。
git --versionwhich -a git有印出版本號就代表可用。第二行看實際會用到哪一個 git。
git --versionwhere.exe git第二行找不到路徑＝沒裝，或 PATH 沒生效。
| 狀況 | 處理 |
|---|---|
執行 git 跳出「需要命令列開發者工具」 |
觸發安裝，跳出視窗後按「安裝」，約 5–10 分鐘。xcode-select --install |
回報 xcode-select: error: tool 'git' requires Xcode |
工具鏈路徑指到不存在的完整版 Xcode。先看目前指向哪，再重設。xcode-select -psudo xcode-select --reset |
| 命令列工具裝過但壞掉，重裝也沒反應 | 整包刪掉重裝。刪除後會跳出安裝視窗。sudo rm -rf /Library/Developer/CommandLineToolsxcode-select --install |
| 卡在 Xcode 授權合約未同意 | sudo xcodebuild -license accept |
| 想裝比系統內建更新的 Git | 用 Homebrew 安裝。brew install git |
| Apple Silicon 裝完 Homebrew 卻找不到指令 | Homebrew 在 /opt/homebrew，需要載入環境。eval "$(/opt/homebrew/bin/brew shellenv)" |
| Git 可用但沒設定身分，提交時報錯 | git config --global user.name "學員姓名"git config --global user.email "學員信箱" |
| 狀況 | 處理 |
|---|---|
| 還沒裝，想用指令快速安裝 | 用 WinGet 安裝，比手動下載快。winget install --id Git.Git -e --source winget |
| 公司電腦沒有系統管理員權限，安裝被擋 | 改用使用者範圍安裝，不需要管理員。winget install --id Git.Git -e --scope user |
裝完了但 git --version 還是說找不到 |
PATH 尚未重載。關掉所有終端機視窗與 Claude 桌面版，再重開。仍不行就登出 Windows 再登入。 |
| Claude 找不到 Git Bash | 在設定檔 settings.json 指定路徑：{"env":{"CLAUDE_CODE_GIT_BASH_PATH":"C:\\Program Files\\Git\\bin\\bash.exe"}} |
| 公司 Proxy 造成 SSL 憑證錯誤 | 改用 Windows 憑證存放區，不要關掉憑證驗證。git config --global http.sslBackend schannel |
| 路徑過長導致操作失敗（Filename too long） | git config --global core.longpaths true |
| 換行符號警告一直跳（LF／CRLF） | git config --global core.autocrlf true |
| PowerShell 說「因為這個系統上已停用指令碼執行」 | 只放寬目前使用者，不要用 Unrestricted。Set-ExecutionPolicy -Scope CurrentUser RemoteSigned |
| Git 可用但沒設定身分 | git config --global user.name "學員姓名"git config --global user.email "學員信箱" |
不要用 sudo 幫學員硬裝東西。當下看起來會過，但會留下權限問題，之後更難處理。
不要關掉 SSL 憑證驗證（http.sslVerify false）。遇到公司 Proxy 請用上面的 schannel 做法。
裝不起來的先給備援。準備已裝好的機器或雲端環境讓他跟上課程，不要讓他整堂課耗在安裝上。
開課前三天寄出，只要三件事：一、確認帳號能登入 claude.ai。二、照這份手冊裝好桌面版（Windows 記得裝 Git）。三、卡住的人在開課前一天回報，不要留到當天早上。
學員報名後最常問的問題。點開看答案。
跟得上。桌面版全程是圖形介面，用中文打字就能操作，不需要看得懂程式碼，也不需要使用終端機。
課程設計是從你自己的工作情境出發，實作題目不會要求你手寫程式。
請直接問課程窗口或你的主管。多數企業課程會統一開通帳號，你只要確認信箱有收到邀請、並且能登入 claude.ai 就好。
如果公司不提供，你需要自備 Claude Pro（或以上）訂閱。免費方案不能用 Code 功能，這點務必在課前確認。
網頁版是對話：你貼內容進去、它回你文字，你再複製出來用。
桌面版的 Code 分頁是做事：它可以直接讀你電腦裡的檔案、修改檔案、執行動作，做完再回報。差別在於它能真的動手，而不只是給建議。這也是為什麼它有權限模式——因為它會動到你的東西。
順帶一提，桌面版裡的 Chat 分頁就等同網頁版，不會碰你的檔案。
不用。桌面版已經包含全部需要的東西，課程也全程使用圖形介面。
Windows 使用者唯一要另外裝的是 Git，而那也只是一個按「下一步」的安裝程式，裝完就不用再管它。
這是官方的硬性要求：Windows 上沒有 Git，本機工作階段就無法啟動。Mac 因為系統通常已內建，所以不用另外裝。
你不需要學會使用 Git，裝好放著就行。它在背後負責記錄檔案的改動歷史，也是 /rewind 能把檔案退回去的基礎。
預設不會。Claude 只看得到你用 Select folder 選的那一個資料夾及其底下的內容，不會去翻你電腦的其他地方。
而且在預設的 Manual 模式下，它每次要改檔案都會先顯示差異檢視讓你確認。你沒按同意，檔案不會被改。課堂練習請用獨立的練習資料夾，不要直接對著重要專案操作。
會。Claude 讀到的檔案內容會傳到 Anthropic 的伺服器由模型處理，這是它能運作的前提。
請遵守兩件事：一、依公司的資安規範辦理——若公司對 AI 工具有規定（可用範圍、哪類資料禁止上傳），以公司規定為準。二、練習資料夾裡不要放敏感資料——個資、客戶名單、合約、未公開的財務數字都不要放。
如果公司對資料留存有特別要求，請洽 IT 或課程窗口確認帳號方案的設定，不要自行判斷。
課堂預設用 Opus 5，需要時會請大家切到其他模型做比較。
如果你用的是公司開通的訂閱帳號，課堂用量通常涵蓋在方案內，不會另外計費。用 /usage 可以隨時查看自己的用量。各模型的費率見第 14 節的成本總表。
先試這三招：一、斷開 VPN 再下載一次（最常見的原因）。二、Windows 的 SmartScreen 點「其他資訊 → 仍要執行」。三、Mac 的安全性提示到系統設定按「仍要打開」。
都不行的話，請在開課前一天回報給課程窗口，我們會準備已裝好的備援環境讓你上課，不要留到當天早上才說。
要。課程是實作導向，用你自己的真實工作素材效果最好——一份你近期做過的文件、報表或稿件都可以。
注意兩件事：素材請先去識別化（拿掉個資與敏感數字），並且放在獨立的練習資料夾裡，不要直接對著正式檔案操作。
可以。從側邊欄開新的工作階段，每個階段有自己的脈絡與改動紀錄，彼此不會互相干擾。課程後段會示範怎麼用。
會在背景自動更新。若想確認是最新版，把應用程式完全關掉再重開即可強制檢查一次。
如果 /model 選單裡看不到課程要用的模型，通常就是版本還沒更新到，重開一次多半就好了。
對話紀錄與設定存在你自己電腦的使用者資料夾底下（.claude）。在應用程式裡可以回到先前的工作階段。
要清掉的話，刪除該資料夾即可，但這會一併刪掉你的設定與所有歷史紀錄，刪之前請確認。
只要你的帳號訂閱還有效就可以繼續用，裝好的環境不會因為課程結束而失效。
如果帳號是公司統一開通的，課後是否保留請洽課程窗口——這牽涉到公司的授權配置，我們無法代為決定。
可以，兩者是同一個引擎，也可以同時安裝、共用設定。但課堂統一使用桌面版，示範步驟與助教支援都以桌面版為準。
如果你要自行安裝指令列版本，請見下方的附錄：指令列版本，但請不要在課堂上要求助教協助指令列的問題。
三家主要供應商的現行 API 費率對照，供選型與估算成本參考。單位是美金／每一百萬 tokens，分成輸入（你送進去的內容）與輸出（模型產生的內容）兩種價格。
輸出通常是輸入的 5–6 倍價，所以「叫它寫很長」比「餵它很多資料」貴得多。一個中文字約 1–2 個 token，一百萬 tokens 大約是五十萬到一百萬個中文字。
舉例：用 Opus 5 讀一份三萬字的報告（約 5 萬 tokens）並產出三千字摘要（約 5 千 tokens），成本約 0.25 + 0.125 = 0.375 美元，不到台幣 15 元。
| 模型 | 定位 | 輸入 | 輸出 | 脈絡 |
|---|---|---|---|---|
| Claude Fable 5 | 能力最強、長任務 | $10 | $50 | 1M |
| Claude Opus 5 | 複雜推理與代理式工作 | $5 | $25 | 1M |
| Claude Sonnet 5 | 速度與智慧平衡 | $3 | $15 | 1M |
| Claude Haiku 4.5 | 最快、最便宜 | $1 | $5 | 200K |
Claude Sonnet 5 於 2026 年 8 月 31 日前適用推廣價 $2／$10。
| 模型 | 定位 | 輸入 | 輸出 | 長脈絡費率 |
|---|---|---|---|---|
| GPT-5.6 Sol | 旗艦 | $5 | $30 | $10／$45 |
| GPT-5.6 Terra | 均衡，適合正式環境 | $2 | $12 | $4／$18 |
| GPT-5.6 Luna | 大量、成本敏感 | $0.20 | $1.20 | $0.40／$1.80 |
| GPT-5.5 | 前一代旗艦 | $5 | $30 | $10／$45 |
| GPT-5.5 Pro | 最高階推理 | $30 | $180 | — |
| GPT-5.4 | 前一代主力 | $2.50 | $15 | $5／$22.50 |
| GPT-5.4 mini | 輕量 | $0.75 | $4.50 | — |
| GPT-5.4 nano | 最輕量 | $0.20 | $1.25 | — |
GPT-5.6 系列在超過 272K tokens 的請求適用右欄的長脈絡費率。
| 模型 | 定位 | 輸入 | 輸出 |
|---|---|---|---|
| Gemini 3.6 Flash | 現行主力 | $1.50 | $7.50 |
| Gemini 3.5 Flash | 前一代主力 | $1.50 | $9 |
| Gemini 3.5 Flash-Lite | 輕量 | $0.30 | $2.50 |
| Gemini 3.1 Flash-Lite | 輕量（前一代） | $0.25 | $1.50 |
| Gemini 2.5 Pro | 高階推理 | $1.25 | $10 |
| Gemini 2.5 Flash | 快速 | $0.30 | $2.50 |
| Gemini 2.5 Flash-Lite | 最便宜 | $0.10 | $0.40 |
Gemini 2.5 Pro 超過 200K tokens 的請求費率提高為 $2.50／$15。部分模型的音訊輸入另有費率。
課程不使用，也不需要安裝。僅供已經習慣終端機的人自行參考。桌面版與指令列版是同一個引擎，可以同時安裝並共用設定。
macOS、Linux、WSL——在終端機執行：
curl -fsSL https://claude.ai/install.sh | bashWindows——在 PowerShell 執行：
irm https://claude.ai/install.ps1 | iex安裝完成後確認版本，並執行環境健檢：
claude --versionclaude doctor在專案資料夾裡輸入 claude 即可啟動；輸入 /exit 離開。更新用 claude update。
助教請注意：課堂上不支援指令列版本的問題排解。若學員自行安裝後遇到狀況，請引導他改用桌面版完成課程，課後再自行處理。
本手冊的安裝流程、模型名稱、權限模式與費率，均依 Anthropic、OpenAI、Google 官方文件與定價頁於 2026 年 8 月 2 日核對。
各家產品與價格更新頻繁，開課前一個月建議重新核對一次。內容若與官方文件不一致，以官方文件為準。