orientation/Claude Code/Tape 01

在 Claude 上安裝並登入,把 AI 跑起來

這一卷處理各平台的安裝與設定。先下載 App、登入帳號、跑完 onboarding;CLI 只要設定到能登入,之後才拿來做跨平台調用。

30分鐘內完成 App、登入與第一次測試
1先設定 Claude Code,不同時碰三套工具
5App、CLI、登入、onboarding、權限

先把工具裝到能跑

setup path

這一卷不教你寫任務卡,也不急著做產品。目標只有一個:讓你選的 AI 工具在你的電腦上可以登入、可以讀資料夾、可以建立檔案、可以請你確認命令。

這一卷的完成標準很簡單:你可以打開你選的 AI 工具,登入自己的帳號,讓它在一個安全的測試資料夾裡讀檔、建立檔案,並在需要動到電腦時向你詢問確認。
先不要把真專案丟進去,也不要急著開自動權限。第 01 卷只是在你的電腦上建好入口,讓第 02 卷開始能把「一句聊天需求」變成 agent 接得住的任務。
鍵盤快捷鍵

本課的快捷鍵以 Mac 為主。Windows 使用者:把 Cmd 換成 Ctrl(例如 Cmd+N 就是 Ctrl+N)、Option 換成 Alt;其他像 Ctrl+CEsc 兩邊一樣。內文的快捷鍵滑上去也會顯示 Windows 對照。

01

先下載 Claude Desktop

如果你還不熟終端,先從 Claude Desktop 開始。這一步不是要你立刻會用所有功能,而是確認帳號能登入、App 能正常打開、你知道從哪裡進入 Claude Code。
下載頁:Claude 官方下載。安裝完成後,第一次打開會先看到 onboarding 畫面。
  • 到官方下載頁安裝 Claude Desktop。
  • 用你之後要上課的 Claude 帳號登入。
  • 登入後先看帳號狀態,不要急著連真專案。
official downloaddownload button

圖示:到 Claude 官方下載頁,依照你的系統下載桌面 App。

get started screenfirst launch

圖示:安裝完成後第一次打開 Claude App,會看到 Get started 畫面;先點這裡進入登入流程。

如果你現在只有 Claude 網頁版,也可以先完成帳號確認;但後面要做跨平台調用,還是會需要本機端入口。

02

CLI 先設定到能登入即可

CLI 在第 01 卷的目的不是要你用終端完成工作流,而是先把「可被調用的入口」準備好。只要能安裝、能檢查版本、能登入同一個 Claude 帳號,這一步就完成了。
官方設定頁:Claude Code CLI setup
Mac 請打開內建的 Terminal(終端機)。你可以在 Spotlight 搜尋「Terminal」或「終端機」,打開後貼上安裝指令。
Mac Terminal
curl -fsSL https://claude.ai/install.sh | bash

先不裝 CLI 也可以,但請在筆記裡標記「CLI 後補」。後面要跨平台調用時,再回來補上。

安裝後檢查
claude --versionclaude doctor
看得到版本,代表終端找得到 Claude Code;`doctor` 能幫你檢查環境是否正常。如果這一步卡住,先截圖錯誤,不要亂改系統設定。
03

登入同一個 Claude 帳號

Desktop 和 CLI 都建議使用同一個 Claude 帳號。這樣後面跨平台調用時,額度、權限與工作紀錄比較不會搞混。先選你現在要走的入口,看完對應分頁即可。
桌面版先確認帳號能登入,再切到左上 Code。這一步完成後,你就知道 App 端的 agent 入口在哪裡。
sign in screendesktop login

圖示:可以使用 Google 登入,或輸入 email 後繼續。

main screencode entry

圖示:登入後回到 Claude 主畫面,點左上 Code 進入 Claude Code 工作入口。

04

選 Local,再建立安全測試資料夾

進入 Code 之後,先確認工作環境是 Local。Local 代表 Claude Code 會在你這台電腦上工作;Cloud、SSH、Remote Control 都是之後才會用到的入口,這一卷先不用急著設定。
接著再選一個乾淨的資料夾。第一次測試不要用真專案,請建立一個空白資料夾,只放一兩個測試檔,讓 Claude Code 練習讀取、建立、修改、回報。你要先熟悉它怎麼要求權限,再讓它進入更重要的工作資料夾。
選 Local,在桌面建一個 claude-code-test 資料夾,用資料夾選擇器選取它,Claude Code 就會在這個資料夾裡工作。
environment menulocal first

圖示:先選 Local,代表這次在自己的電腦上工作。Remote Control 是之後用 `claude rc` 讓其他入口連回本機的方式,這一卷先知道位置即可。

folder pickersafe workspace

圖示:資料夾選單會顯示最近使用過的資料夾。第一次請用新建的測試資料夾;如果沒有出現,就點 Open folder 選它。

進入 Claude Code 後,可以請它做一個很小的測試:建立一份 `hello.md`,寫三行今天的設定結果,然後回報它建立了哪個檔案。
貼給 Claude Code 的測試任務

請在目前資料夾建立一個 hello.md 檔案,內容用三行寫下: 1. Claude Code 已經可以啟動 2. 目前正在測試安全資料夾 3. 下一步是學會把聊天需求改成任務卡 完成後請回報你建立了哪個檔案,以及你做了哪些操作。

這個測試的重點不是檔案內容,而是你要看懂:它準備做什麼、它要你確認什麼、做完之後怎麼回報。

05

看懂權限,再決定要不要 Bypass

權限設定是 Claude Code 從聊天工具變成 agent 工作台的分水嶺。你如果像 Shane 一樣習慣用 Bypass,工作速度會很快;但前提是你要知道它跳過了哪些確認,以及你自己要替哪些風險負責。
Claude Code 的權限不是「能不能用」這麼簡單,而是三個層次:工具要不要問你、這次 session 用哪種模式、哪些檔案或命令永遠不該放行。
Allow允許指定工具或命令直接執行,例如 `Bash(git diff *)`。適合你每天都會用、風險低、看得懂結果的動作。
Ask每次執行前都要問你。適合 deploy、push、安裝套件、改設定、操作外部服務這類需要停一下看的動作。
Deny直接禁止。適合 `.env`、secrets、金鑰、私人資料、刪除大量檔案、你不希望 agent 碰到的路徑。
default標準模式。第一次使用工具或命令時會問你,適合第 01 卷的新手測試。
acceptEdits自動接受檔案編輯與常見檔案操作,仍保留部分確認。適合已經知道資料夾範圍的人。
plan只讀與規劃,不改檔。適合先讓 agent 看專案、整理計畫、不要馬上動手。
auto用背景安全檢查自動批准部分操作。比 default 快,但仍不是無腦全放行。
bypassPermissions跳過大多數權限確認。適合隔離環境、測試資料夾、可重建專案,或像 Shane 這種已經能讀懂 agent 動作的人。
Shane 的工作法不是「永遠不要 Bypass」,而是「先把場地清乾淨,再 Bypass」。也就是:只在測試資料夾、Git 已乾淨、沒有 secrets、沒有 production 憑證、能接受整個資料夾重建的狀態下開。
在 Code 主畫面切 Mode 選單,選 Bypass permissions 就是熟手路線;不確定就先留在 default。
mode menupermission mode

圖示:點底部 Mode 可以切換 Ask permissions、Accept edits、Plan mode、Auto mode 或 Bypass permissions。Shane 習慣用 Bypass,但要先確認場地乾淨。

  • 可以放行:讀測試資料夾、建立測試檔、查看目前資料夾內容、跑 `git diff` 或 `ls`。
  • 要 Ask:安裝套件、跑 build、寫入設定檔、push、deploy、呼叫外部工具。
  • 要 Deny:讀 `.env`、讀 secrets、刪除大量檔案、操作 production、碰你看不懂的系統設定。
  • 要 Bypass:先確認這個資料夾沒有重要秘密,Git 狀態乾淨,出事可以還原。
06

常用介面和模型選擇

權限看懂之後,再認底部狀態列。你現在只需要知道三件事:目前在哪個工作資料夾、這次用哪個模型、額度是不是快用完。先不要把模型選擇變成另一個研究題。
model pickermodel choice

圖示:點模型名稱可以切換 Opus、Sonnet、Haiku 等模型。剛開始先用預設或課堂指定模型,知道目前使用哪一個即可。

plan usagequota status

圖示:點右下角用量圖示可以看 5-hour limit、weekly all models、Sonnet only 等額度狀態。任務跑不動時,先檢查是不是額度快用完。

資料夾確認 Claude Code 正在你選的測試資料夾工作,不要誤開到真專案。
模型先用預設或課堂指定模型。等你跑過第一條 flow,再比較速度、品質和額度消耗。
額度任務突然停住、模型不可用、速度變慢時,先看 Plan usage,不要馬上懷疑自己設定錯。
完成標準

你已經能打開 Claude Code、登入帳號、在測試資料夾裡建立檔案,說得出 default、Ask、Deny、Bypass 的差別,也知道模型與額度要去哪裡看。到這裡,第 01 卷就完成了。

進第 02 卷前,確認三件事

ready check

完成這三件事,下一卷才開始把聊天需求改成任務卡。這裡不追求完美設定,只要你選的工具能安全地讀資料夾、改測試檔、回報結果,並知道權限、模型、額度要去哪裡看。

01
我已安裝 App,並完成帳號登入
能打開桌面 App,帳號狀態正常;CLI 可選,但建議至少驗一次版本。
required
02
我知道 CLI 是跨平台調用入口
CLI 只要設定到能登入即可;如果現在只用 App,也要知道後面做跨平台調用時會補 CLI。
required
03
我完成第一次安全測試,並看懂基本介面
確認在本機工作、選好測試資料夾,讓工具建立一個小檔案,並知道權限、模型、額度在哪裡看。
next
next tape

第 02 卷:把聊天改成任務交接

下一卷開始,你會把「幫我看看」改成 agent 接得住的任務卡:目標、背景、限制、交付物、驗證方式。

前往第 02 卷