五步上手：裝好住在你電腦裡的 AI

0 / 5 完成

開始之前：五步抓 30–45 分鐘，走完、跟它講完第一句話，課前準備就完成了。
蓋筆記庫、裝工具那些都不用課前做——第一堂會帶著大家實際操作，之後再做壓力小很多。
每一步都有「✅ 完成標準」，打勾就往下走。卡住不是你的問題，是說明寫得不夠好——每步都有求救法，「會求救」本身就是這門課的第一課。

請用自己的電腦：醫院電腦多半有安裝限制，裝不了不是你的問題。
電腦規格不挑：AI 的運算都在雲端，你的電腦只是遙控器。近五年的筆電、系統有在更新（Windows 10/11 或 macOS 11 以上）就行。

★

卡住怎麼辦（這就是第一課）

你不需要先學會，你只需要會問。下面五步裡任何一步卡住，都用這招。

看不懂的畫面、英文報錯：不要自己 google 半天——打開網頁版 AI（claude.ai 或 chatgpt.com）直接問。
卡在報錯訊息：整段複製貼給它，加一句「我是完全沒用過終端機的新手，用五歲小孩能懂的方式告訴我這是什麼、我該怎麼辦」（這就是 ELI5——對 AI 打這個縮寫它就懂）。
網頁版解不動的時候：把模型等級拉高（模型選單裡選最強的那顆），然後開一個全新的對話再問一次——換顆乾淨的腦袋重新看，常常一次就通。
它就是你隨叫隨到的工程師——「不懂就問它」這個動作，本身就是這門課要教的核心。

先選你的組合（頁面會只顯示你需要的指令）

你的電腦

你要用的 AI

還沒決定用哪家？先看 Step 1 再回來選。已經有訂閱哪家就選哪家，不用換。

先問身邊已經在用的同事有沒有「邀請碼」——可以免費試用一段時間（通常一週左右），先體驗再決定。拿到碼的人：點碼裡附的連結（或到帳號頁的兌換入口）輸入就生效；沒有碼就直接訂閱，兩條路結果一樣。
做法（二選一，已經有哪家就用哪家，不用換）：
- Claude：到 claude.ai 從 Pro 開始
- ChatGPT／Codex：Plus 就夠

✅ 完成標準：帳號頁看得到 Pro／Plus 字樣（或邀請碼兌換成功）

裝機

我們要裝的是「住在你電腦裡的 AI」，不是網頁。一行指令，不用先裝任何東西。

Mac 先做：裝一個好用的終端機

到 iterm2.com 下載安裝 iTerm2，之後的操作都在它裡面。
權限現在不用先設定——之後第一次使用時，macOS 會連續跳出好幾個「iTerm2 想要取用…」的詢問（下載項目、文件、圖片、音樂……），這是正常的，不用擔心，按允許就好。
被問過一輪之後，想一次給齊：系統設定 → 隱私權與安全性 → 完整磁碟取用權 → 打開 iTerm2——之後就不會再問了。

Windows：用內建的終端機就好

開始選單搜尋「Windows Terminal」打開（Win11 內建；Win10 沒有的話到 Microsoft Store 免費裝）。

安裝（把這行貼進終端機，按 Enter）

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

裝完先把終端機整個關掉、重開一次——新指令要重開才找得到。

Codex 需要兩步（它得先裝一個叫 Node 的底座）：

① 到 nodejs.org 下載 LTS 版安裝檔，像裝一般軟體一樣裝好
② 打開 iTerm2，貼上：

npm install -g @openai/codex

① 先裝底座：

winget install OpenJS.NodeJS.LTS

② 把終端機關掉重開，再貼：

npm install -g @openai/codex

⚠️ Codex 在 Windows 上官方還標示「實驗性」，卡住是它的問題不是你的——把畫面整段貼給網頁版 AI 問（最上面「卡住怎麼辦」那招）。

驗證＋第一次登入

輸入 claude --versioncodex --version，看到版本數字（例如 2.x.x (Claude Code)codex-cli 0.x.x）就對了。沒反應？先關掉終端機重開再試一次。
輸入 claudecodex → 會跳出瀏覽器 → 用 Step 1 的帳號登入 → 看到 Login successful（字樣大同小異，意思是登入成功就對了）。
登入成功後回到終端機，這一步就完成了——視窗要關掉休息也可以，下一步再開。

🆘 看不懂的畫面或英文報錯：整段複製，貼給 claude.ai 或 chatgpt.com，加一句「我是完全沒用過終端機的新手，用五歲小孩能懂的方式告訴我這是什麼、我該怎麼辦」（這就是 ELI5，對 AI 打這個縮寫它就懂）。

✅ 完成標準：看過一次 Login successful

外觀

兩分鐘，讓它看起來不可怕。預設黑底白字讓很多人覺得「這是工程師的東西」——換亮色，它就只是一個聊天視窗。

iTerm2：Settings → Profiles → Colors → 右下 Color Presets 選 Light Background

為什麼裝 iTerm2，不用 Mac 內建的「終端機」？

內建的也能動，但 iTerm2 的顏色與字型設定比較好找、行為比較穩定，之後課程的畫面也都以它為準——跟著裝，可以少對照一層。

Windows Terminal 走「一鍵貼上」：把下面整段複製、貼進終端機、按 Enter，一次完成「亮色配色＋指令文字配色（永久生效）」。貼上時若跳出「確定要貼上多行文字嗎」，按「全部貼上」。

$wt = @("$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json",
        "$env:LOCALAPPDATA\Microsoft\Windows Terminal\settings.json") | Where-Object { Test-Path $_ } | Select-Object -First 1
$j = Get-Content $wt -Raw | ConvertFrom-Json
if (-not $j.profiles.defaults) { $j.profiles | Add-Member defaults ([pscustomobject]@{}) }
$j.profiles.defaults | Add-Member colorScheme 'One Half Light' -Force
$j | ConvertTo-Json -Depth 20 | Set-Content $wt
Set-PSReadLineOption -Colors @{ Command = 'DarkBlue'; Parameter = 'DarkCyan'; String = 'DarkRed'; Variable = 'DarkGreen'; Default = 'Black'; Number = 'DarkMagenta'; Member = 'DarkGray'; Operator = 'DarkGray'; Type = 'DarkGray' }
New-Item -ItemType Directory -Force (Split-Path $PROFILE) | Out-Null
Add-Content $PROFILE "Set-PSReadLineOption -Colors @{ Command = 'DarkBlue'; Parameter = 'DarkCyan'; String = 'DarkRed'; Variable = 'DarkGreen'; Default = 'Black'; Number = 'DarkMagenta'; Member = 'DarkGray'; Operator = 'DarkGray'; Type = 'DarkGray' }"

腳本跑不動也沒關係，改用手動：Windows Terminal 設定（Ctrl+,）→ 預設值 → 外觀 → 色彩配置 → 選 One Half Light。

字級調到自己看得舒服就好：按住 Ctrl 滾滑鼠滾輪就能調大縮小。
Claude Code 裡面也可以換：打 /theme 選 light

✅ 完成標準：畫面是亮的、字是大的、你看著它不緊張

裝 Obsidian（先開一個空的家）

AI 幫你整理的筆記要有一個家，這個家就是 AI 的工作基地——它以這裡為家；要動別的地方、上網抓東西，都會先跳框問你，這是最重要的安全設計。

到 obsidian.md 下載安裝（免費）。
選「Create new vault」建一個新 vault，名字隨意（例如 MyVault）——放簡單好找的位置就好：Windows 建議 C:\Users\你的名字\MyVaultMac 建議家目錄，也就是選位置時按 Cmd+Shift+H 出現的那層（備份與同步是之後的課，現在先有家）。
裡面先不要建任何資料夾——下一步請 AI 跟你一起設計。

原本就有筆記的人（沒有就跳過這段）

這段不強求，課程結束後再做也完全可以——匯出很卡、檔案太多的人可以先跳過：先了解自己的筆記習慣就好，之後再請 AI 在 Obsidian 開出類似的環境。不搬舊筆記完全不影響上課。過程卡住就問網頁版 AI：「我的筆記在 XXX，要怎麼匯出成檔案？」

Word 檔、舊筆記軟體、散落的 PDF 重點：挑幾十份有代表性的複製進 vault，資料夾取名 Old，大 PDF 先不用搬——AI 蓋新家時會先看你的舊家長什麼樣，它是看你的習慣，不是幫你搬家。
筆記在 Notion：Settings → Export all workspace content → 格式選 Markdown & CSV，解壓縮後把有代表性的丟進 Old。
筆記在 Evernote：選幾本筆記本 → 匯出 .enex 檔，整包丟進 Old 就好——下一步的 AI 看得懂；之後想全部搬家也是請它處理（我自己就這樣搬過）。
筆記在 Google Docs／Word：挑代表作各自「下載為 Word (.docx)」放進 Old，不用先轉格式。

✅ 完成標準：Obsidian 打開，是一個空的（或只有 Old 的）vault

第一句話

裝好不算開始，開口才算。

開終端機，三拍進 vault：先打 cd 加一個空格 → 把 vault 資料夾拖進終端機視窗（路徑會自己出現）→ 按 Enter。之後每次都從這裡開。
輸入 claudecodex。第一次會跳英文問「Do you trust the files in this folder?」——按 Yes，這是你自己剛建的資料夾。
然後打這句（中文長句在終端機打字不順的話，先在記事本打好再貼上；第一堂會教用講的）：

第一句話（照抄）

你好，我是第一次用終端機 AI 的醫療人員。請用三句話告訴我：你是誰、你能幫我做什麼。這個資料夾現在是空的，之後上課我會請你幫我把它蓋成我的筆記庫。

✅ 完成標準：它回答了你——恭喜，你已經在跟住在你電腦裡的 AI 對話了。五步全部完成，課前準備達標，第一堂見！

跟它一起蓋你的筆記庫（選配：第一堂之後做也完全可以）

第一件正事，留 20–30 分鐘。資料夾結構不該是別人塞給你的，該是你跟你的 AI 討論出來的——這一步同時就是這門課最重要的練習：交代一件事、來回討論、驗收成果。

還不想跑？完全沒問題。第一堂會先帶你實際用過一輪、看懂那些權限框在問什麼，回家再做這步會順很多——課前做到 Step 5 就已經達標。

先知道這件事，等下才不會緊張：接下來它會不時跳出「權限確認框」，用英文問你「可不可以做某件事」——那是安全帶，不是警報。這次任務只會動你這個資料夾：看到讀網頁、建資料夾（mkdir）、寫檔案都可以放行；它每次都會把「要做什麼」寫在框裡，看不懂就整段貼給網頁版 AI 翻譯。權限的完整判讀，第一堂課教。

做法：貼這段（照抄，網址不要改）：

蓋筆記庫 prompt（照抄）

請讀這份文件：https://raw.githubusercontent.com/drpwchen/ai-starter-kit/main/BOOTSTRAP.md 這是別人設計好的筆記庫起手式。請先用白話解釋：預設的 5 個資料夾各是幹嘛的、給你的工作守則有哪幾條。然後訪談我——一次只問一題，問到你清楚了解我的需求為止：我平常要記哪些東西（上課？讀書？考試？病例學習？）。我 vault 裡如果有 Old 資料夾，請先看看我舊筆記的樣子（看檔名結構、抽幾份代表作讀就好，不用全部讀）。如果我回答「不知道」，就先照預設建，之後再調。動手前先摘要你聽到的需求給我確認，再照文件把該建的、該裝的都弄好，把我們的決定補寫進去。最後，列出你建了哪些資料夾和檔案給我看。

它會照順序：先解釋 → 一次問一題問到清楚 → 摘要確認 → 動手 → 回報清單。你們討論出來的可能跟預設不一樣——那就對了。
它會提議幫你裝幾個保險與小工具，動手前會先列清單問你（每一樣都寫在起手式文件裡：要裝什麼、為什麼、你都可以說不）：
- git——筆記庫的時光機，改壞了能回上一步
- cc 捷徑——下次開工只要打 cc 就直接進筆記庫叫出 AI；cr 則是接回上次的對話
- CLAUDE.md——讓它每次開機都記得守則
- 一個小提醒 hook——存筆記沒寫出處時提醒你（課堂會揭牌它是什麼）
- claude-pacer——額度油表，看得到這個月還剩多少
哪個不想裝或裝不起來就跳過，完全不擋後面——裝不起來的，把報錯整段貼給網頁版 AI 問（第一課那招）。

✅ 完成標準（四個都要）：①它最後列出的清單跟起手式的預設對得上，或差異是你們討論過的（不是它自己發明的）②Obsidian 打開真的看得到這些資料夾 ③開一個全新的終端機視窗，打 cc——直接回到筆記庫裡的 AI，代表捷徑活了（沒反應就把畫面貼給它問）④你答得出「為什麼是這幾個資料夾」

🆘 卡住：把畫面整段貼給網頁版 AI（第一課那招）；還是解不開，把卡住的點寫進課前調查最後一題，第一堂我直接處理。