跳到主要內容

Claude Code CLI 完整安裝教學：Windows 開發者專屬的終端機 AI 助手


嗨！各位熱愛技術與追求高效率的開發者們，歡迎來到這篇專為 Windows 使用者打造的深度教學！身為現代軟體工程師，我們每天都要面對海量的程式碼、難解的 Bug，以及不斷推陳出新的技術框架。如果能有一個聰明絕頂的 AI 助手，直接住在你的終端機（Terminal）裡，隨時幫你讀 Code、寫腳本、甚至自動抓蟲，那該有多好？沒錯！Anthropic 官方近期推出的 **Claude Code CLI** 就是這個夢幻神器！它徹底打破了過去我們需要在網頁版 ChatGPT 或 Claude 之間來回複製貼上的繁瑣流程。今天，我將手把手帶你從零開始，在你的 Windows 系統上完美安裝並設定好這位超強大的 AI 結對程式設計師（Pair Programmer）。無論你是資深的後端大神，還是剛接觸前端的新手，這篇教學都能讓你輕鬆無痛上手，大幅提升你的工作品質與開發效率！準備好讓你的生產力起飛了嗎？我們馬上開始吧！

 

 

1. 什麼是 Claude Code CLI？為什麼它會成為開發神兵利器？

在我們進入繁瑣的安裝步驟之前，讓我們先來聊聊為什麼這套軟體在開發者社群中引起了如此巨大的迴響。CLI (Command Line Interface) 也就是我們常說的「命令列介面」或「終端機」。過去，當我們在寫程式遇到瓶頸，或是需要重構一段複雜的函式時，標準動作是：開啟瀏覽器 → 登入 AI 平台 → 複製你的程式碼 → 貼上並加上提示詞 → 等待生成 → 再把結果複製回編輯器。這整個過程不僅打斷了心流，有時候如果專案比較大，你根本無法將整個資料夾的脈絡都貼給 AI 看。

Claude Code CLI 完美解決了這個痛點！ 它是由 Anthropic 官方釋出的強大工具，讓你可以在終端機中直接敲擊鍵盤，與 Claude 進行對話。更厲害的是，它可以直接讀取你當前工作目錄（Workspace）下的所有檔案。這意味著，當你下達：「請幫我看看 src/components/Header.jsx 為什麼在手機螢幕上會跑版？」時，它會自己去翻閱那個檔案，甚至順藤摸瓜去看你關聯的 CSS 檔案，然後直接給你精準的解答或修改建議。這就像是聘請了一位經驗豐富的資深工程師，全天候坐在你旁邊看你寫 Code 一樣，絕對能大幅提升你的程式碼品質！

2. 課前準備：在 Windows 建立 Node.js 執行環境

因為 Claude Code CLI 是基於 Node.js 開發的 npm 套件，所以在正式安裝它之前，我們的 Windows 電腦必須先具備 Node.js 的執行環境。如果你的電腦已經安裝過了，可以跳過這一步驟；如果你不確定，我們一起來檢查看看吧！

✅ 檢查 Node.js 狀態：
請按下鍵盤上的 Win + R，輸入 cmd 開啟命令提示字元，或者是開啟你愛用的 PowerShell / Windows Terminal。接著在裡面輸入：

node -v
npm -v

如果你看到類似 v18.17.0 或更高的版本號碼，那就恭喜你，你的環境已經準備就緒了！官方強烈建議使用 Node.js 18 或以上的版本，以確保所有的非同步功能與最新的 JavaScript 特性能夠完美運作。

如果出現「找不到指令」或版本太舊怎麼辦？

  1. 請動用你的滑鼠，前往 Node.js 官方網站。
  2. 在首頁，你會看到兩個大大的下載按鈕。請毫不猶豫地選擇標示著 LTS (Long Term Support, 長期支援版) 的那個按鈕，這對 Windows 使用者來說是最穩定、最不容易出錯的選擇。
  3. 下載完成後，執行安裝檔。安裝過程中，請一直點擊「Next」，但務必要在某個畫面中確認勾選了「Add to PATH」（加入環境變數）的選項（通常預設是勾好的）。這一步非常關鍵，沒有它你的終端機就不會認得 npm 指令。
  4. 安裝完畢後，請務必重新啟動你的終端機，再次輸入 node -v，確認安裝成功！

3. 正式安裝：將 Claude 召喚到你的終端機

萬事俱備，只欠東風！有了 Node.js 和 npm 的加持，安裝 Claude CLI 就如同喝水一樣簡單。不過，為了避免 Windows 常見的權限問題（Permission Denied），我會強烈建議你在這一步驟使用系統管理員權限來操作。

請在你的 Windows 開始選單中，找到 PowerShell 或命令提示字元，對著它點擊右鍵，選擇「以系統管理員身分執行」。接著，在黑色的視窗中，鄭重地敲下這行魔法指令：

npm install -g @anthropic-ai/claude-code

來稍微解釋一下這行指令：install 顧名思義就是安裝；而關鍵的 -g 參數代表的是 Global（全域安裝）。這意味著我們不是只把 Claude 安裝在目前這個資料夾裡，而是把它安裝到系統的深處，讓你未來無論在哪個專案資料夾底下，都能隨時呼叫它。後面的 @anthropic-ai/claude-code 則是官方在 npm 上的正式套件名稱。

依照你目前的網路速度，這個過程大約會需要 30 到 60 秒鐘，螢幕上會跑過一堆進度條。當一切平息後，讓我們來驗證一下成果：

claude --version

如果你能在終端機上看到一串乾淨俐落的版本號碼，那麼恭喜你！這位地表最強的 AI 助手已經正式入駐你的 Windows 電腦了！

4. 授權與登入：讓 Claude 認識你

軟體雖然裝好了，但 Claude 可是很重視安全與隱私的，我們必須先證明「你是你」，也就是完成 Anthropic 帳號的綁定與授權，才能夠開始消耗你的 API 額度或訂閱方案。請放輕鬆，這個過程非常自動化且順暢。

在終端機中，輸入這行登入指令：

claude auth login

按下 Enter 後，系統通常會自動彈出你電腦的預設瀏覽器（例如 Chrome 或 Edge），並導向 Anthropic 的官方授權頁面。如果你已經在該瀏覽器中登入了 Claude 網頁版，系統可能會直接要求你點擊授權按鈕；如果你還沒登入，請依照畫面的指示，使用你的 Email 或是 Google 帳號完成登入。

💡 進階技巧：手動設定 API Key
對於一些有特殊資安控管的企業使用者，或者是你希望嚴格控管 API 花費的資深玩家，你可能會不想透過網頁授權。這時候，你可以前往 Anthropic Console (開發者控制台) 申請一組獨立的 API Key。然後在你的 Windows 系統環境變數中，新增一個名為 ANTHROPIC_API_KEY 的變數，並填入你的密鑰。這樣一來，Claude CLI 啟動時就會自動讀取這個變數，不需再透過瀏覽器驗證了！

5. 實戰演練：你的第一句 Claude 指令

終於來到最令人興奮的時刻了！現在，請開啟你的程式碼編輯器（例如最受歡迎的 VS Code），並打開一個你正在進行的專案資料夾。接著，使用快捷鍵 Ctrl + ` 叫出 VS Code 內建的終端機。

在終端機中，大膽地輸入這六個字母：

claude

這時，你的提示字元（Prompt）會發生變化，表示你已經正式進入了 Claude 的互動模式！在這裡，你可以直接用自然的台灣繁體中文對它下達指令。以下幾個是我自己每天開發必用的超實用情境，強烈建議你跟著試試看：

🔍 1. 專案架構掃描

這是我接手新專案時的第一步。你可以對它說：
「我是剛加入的開發者，請幫我分析這個專案的架構，並告訴我主要的進入點在哪裡？」
它會快速掃描你的 package.json 和資料夾結構，給你一份清晰的簡報。

🐛 2. 精準除錯 (Debug)

當終端機噴出一堆紅字時，直接問它：
「幫我看看 utils/formatDate.js 裡面的函式，為什麼我傳入 ISO 字串時它會報錯？」
Claude 會直接看那個檔案，甚至幫你寫好修正後的程式碼片段。

✨ 3. 自動化重構腳本

繁瑣的苦力活就交給 AI：
「請幫我寫一段 Python 腳本，找出 src 資料夾下所有沒有被使用的圖片，並把它們移動到 archive 資料夾中。」
它不僅會給你代碼，甚至能在你的許可下直接幫你執行！

在互動模式中，如果你想清理版面，可以輸入 /clear；如果想結束對話回到原本的 Windows 環境，只要輸入 /exit 或是按下兩次 Ctrl + C 就可以優雅退出了。

6. 常見問題排除 (Troubleshooting)

在 Windows 上開發，難免會遇到一些小脾氣，這裡我整理了部落客與網友們最常遇到、也是最讓你頭痛的幾個小問題與解決方案：

  • Q: 終端機顯示「'claude' 不是內部或外部命令」？
    A: 這 99% 是因為 npm 的全域路徑沒有被加進 Windows 的環境變數 (PATH) 裡。請先在終端機輸入 npm config get prefix 來獲取路徑（通常會在 C:\Users\你的名字\AppData\Roaming\npm）。接著，按下 Win 鍵搜尋「環境變數」，點擊「編輯系統環境變數」，在「Path」中新增這個路徑。最後，務必重開所有終端機視窗，通常就能解決了！
  • Q: 出現權限錯誤 (Permission denied) 或 EPERM？
    A: Windows 有時候對檔案鎖定比較嚴格。請確保你的防毒軟體沒有阻擋 npm 的寫入行為，並且嘗試在「以系統管理員身分執行」的 PowerShell 中重新下達安裝指令。
  • Q: 為什麼 Claude 說找不到我的檔案？
    A: 請確認你啟動 claude 指令的「當前目錄位置」是正確的。如果你的專案在 D:\Project\my-app，你就必須先用 cd D:\Project\my-app 切換過去，再啟動 Claude，它才能看見你的檔案。
⚠️ 溫馨免責聲明：
本篇文章提供之技術教學與程式碼操作，僅供讀者學習與參考之用。執行任何命令列指令（尤其是全域安裝或自動化腳本）前，請務必了解其背後的意義，並建議定期備份您的重要專案資料。由於軟體版本更新頻繁，實際介面與指令可能與本文撰寫時有所差異。若因操作不當導致資料遺失或系統異常，讀者須自行承擔相關風險。將程式碼授權予 AI 讀取時，也請留意您所在企業或專案的資安規範與保密協議（NDA）。

留言

張貼留言

這個網誌中的熱門文章

讓 AI 成為你的教學「分身」，準時下班不是夢—— GEM 教學應用實戰 (Google Educator Masterclass)

各位老師，辛苦了！在現今的教育現場，繁重的行政報表、課綱教案與親師溝通，總是把時間切割得零碎，「準時下班」似乎成了都市傳說。這份「GEM 教學應用實戰講義」，並非要讓 AI 取代您的教學專業，而是帶您打造一個不知疲倦、隨傳隨到的「數位分身」。     寫在前面：為什麼我們需要 AI 教學分身？ 教師的角色早已不只是「傳道、授業、解惑」。透過掌握關鍵 AI 應用，我們要把省下來的時間，還給您自己，或是還給那些真正需要您陪伴的學生。 💡 核心心法： 「AI 負責打底與高效產出，老師負責審核與靈魂注入。」 第一章：課前準備與專屬「百寶箱」建置 在開始詠唱提示詞之前，建立一個順暢的數位工作環境是成功的一半。 1-1 雙螢幕/分割畫面操作（線上研習必備） 在線上實作研習中，最常發生的悲劇就是「切去操作 AI 視窗，就找不到講師的畫面了」。 Windows 系統秘技： 點選瀏覽器視窗上方標題列，按下鍵盤 Windows鍵 + 左/右方向鍵 ，視窗會瞬間對半貼齊螢幕。 Mac 系統秘技： 將游標懸停在視窗左上角的「綠色全螢幕按鈕」上，選擇「將視窗平鋪於螢幕左/右側」。 最佳配置： 左半邊放置 Google Meet 畫面（看講師示範），右半邊開啟您的 AI 助手與百寶箱網頁。 1-2 專屬百寶箱：線上指令庫快速連結 本次研習主辦方已經為大家建置了最強大的線上指令庫。我們不需要到處找檔案，請直接點選以下連結開啟這兩個專屬網站，它們就是你未來的「虛擬大腦」： 📖 GEM 教學「分身」 教師減負全方位應用指南 ⚙️ GEM 行政「引擎」 國中小處室效能提升指南 第二章：基礎賦能 —— 讓 AI 秒懂你的「5 元素萬用公式」與風險控管 很多人覺得 AI 給的答案「很廢、像官樣文章」，原因在於我們的指令太模糊。如果你遇到百寶箱中沒有的情境，請記住這個萬用公式。 2-1 破解黑盒子：5 元素提示詞公式 要讓 AI 產出精準的內容，請牢記： 「對象 ＋ 任務 ＋ 限制 ＋ 格式 ＋ 目的」 【對象】： 年級、程度、班級特性（例：針對注意力不集中的國一學生）。 【任務】： 教材、評語、活動、回覆（例：設計一份閱讀測驗）。 【限制】： 字數、時間、堂數、語氣（例：限 300 字，語氣要幽默）。 【格式】： 表格、條列、逐字稿、題庫（例：請用表格呈現，欄位包含....
張貼留言
閱讀完整內容

2026高齡駕駛換照懶人包：70歲新制、75歲認知功能測驗、繳回駕照TPASS回饋一次看

家中長輩滿70歲、仍會騎車或開車出門嗎？預計2026年5月31日，高齡駕駛換照制度正式下修到70歲，但這不是要禁止長輩開車，而是透過體檢、交通安全教育與分級把關，讓長輩更安心、家人也更放心。本文已把容易誤會的期限、認知功能檢測與TPASS回饋方式完整整理，陪你用最清楚的方式看懂新制。     導讀區：這篇先幫你抓重點 這次高齡換照新制最容易被誤會的地方有三個：第一，不是所有人都要立刻衝去監理站，原則上要等監理所、站通知；第二，70歲到未滿75歲與75歲以上流程不同；第三，繳回駕照的3.6萬元不是一次領現金，而是符合資格後依實際搭乘大眾運輸支出給50%回饋。 70歲新制 體檢合格，加上免費安全教育與危險感知體驗，通過後駕照可使用到75歲。 75歲以上 維持每3年換照，需體檢、認知功能檢測或提出未患中度以上失智症證明。 放下方向盤 70歲以上自願繳回名下所有駕照，可申請TPASS乘車回饋，2年最高3.6萬元。 文章目錄 點擊快速跳轉 1. 2026高齡換照新制先看懂 2. 70歲與75歲流程差在哪 3. 換照流程照著做就好 4. 認知功能檢測考什麼 5. 出門前證件與費用清單 6. 逾期未換照的罰則 7. 繳回駕照與TPASS回饋 8. 家人陪辦提醒與常見問題 1. 2026高齡換照新制先看懂 預計2026年5月31日起，台灣高齡駕駛換照制度進入新的分級管理階段。過去大家比較熟悉的是75歲以上高齡駕駛換照，現在新制把關懷年齡提早到70歲，重點不是把長輩的車鑰匙收走，而是讓長輩在身體狀況還不錯的時候，透過體格檢查、安全教育課程與危險感知體驗，重新確認自己是否適合繼續騎車或開車。 這件事對很多家庭很實際。長輩可能每天騎機車買菜、接孫子、去醫院回診，也可能習慣自己開車到市場、活動中心或鄰近鄉鎮辦事。交通工具對長輩來說不只是移動方式，也是一種生活自主感。所以談高齡換照時，語氣不應該是「你老了不能開」，而是「我們一起確認怎麼出門比較安全」。 最重要的一句話 滿70歲以上長者原則上等監理所、站寄發換照通知再辦理，不需要因為聽到新制就急著提前換照。若有違規、吊扣、逾期或個案通知，則依監理機關通知內容辦理。 如果你是子女或晚輩，建議先不要用命令式口氣要求長輩放棄駕駛。比較好的做法，是陪他一起看通知書、安排體檢、理解流程，也一起討論如果未來少開車，附近有哪些公車、捷運、...
張貼留言
閱讀完整內容

「2026台北鼠患危機：25年首見漢他病毒！見鼠地圖與滅鼠生態反撲全解析」

哈囉大家好！最近生活在台北的大家，出門走跳時有沒有覺得心裡毛毛的呢？2026年的台北街頭，不僅天氣變化多端，還迎來了一場讓人不容忽視的「鼠患風暴」。不僅是路上看到米奇的機率變高了，更可怕的是，伴隨而來的漢他病毒已經敲響了公衛警報！今天這篇文章，我將帶大家深入了解這次的鼠患危機、民間與市府的滅鼠大作戰，以及我們在撲滅老鼠的同時，必須正視的生態悲歌。準備好了嗎？讓我們一起看下去吧！     1. 25年首見！漢他病毒拉響台北公衛警報 時間拉回今年1月，台北市出現了讓所有醫療人員高度戒備的新聞—— 25年來首宗漢他病毒（Hantavirus）死亡案例 。一位居住在大安區的70多歲長輩因為感染不幸離世，緊接著今年又出現了第二宗確診案例。這不僅僅是冰冷的數字，更意味著藏匿在城市暗處的鼠患，已經直接威脅到市民的生命安全與健康。 漢他病毒主要透過老鼠的排泄物、尿液傳播，當帶有病毒的微粒飄散在空氣中被我們不小心吸入，或是接觸到受污染的物品，都有極高的感染風險。面對這樣無形的敵人，我們絕對不能掉以輕心，出入髒亂場所記得戴好口罩喔！ 2. 抓鼠大作戰：民間見鼠地圖與市府對策 為了對抗這場危機，不僅官方動起來，民間力量也卯足了全力。熱心網友特別開發了數位化的 「見鼠地圖 Rat Radar (ratdar.taipei)」 ，透過民眾通報，讓大家可以隨時掌握各區的鼠患熱點與毒餌標記，出門時盡量避開高風險區域。 此外，蔣萬安市長也正式宣布，自5月11日起，全市行政區將同步展開清潔行動。市府更成軍了由環保局人員組成的 「鼠類偵防師」團隊 ，超過百名人力將深入社區協助民眾尋找老鼠源頭。為了壓制鼠群數量，據市議會資料指出，市府採購了約1公噸（1000公斤）的老鼠藥投入環境防治，這絕對是一場必須謹慎面對的硬仗！ 2例 漢他確診案例 百人 鼠類偵防師 1公噸 採購老鼠藥 3. 滅鼠的隱形代價：猛禽與生態圈的悲歌 然而，當城市大量使用化學鼠藥來保護人類家園時，大自然卻默默承受了沉重的代價。根據 台灣猛禽研究會 的警告與過往數據顯示，在被尋獲的死亡猛禽中，竟然高達 61%的體內被檢測出鼠藥成分 ！這數據真的讓人非常心痛。 這就是可怕的「次級毒殺」。老鼠吃下毒藥後不會立刻死亡，行動變得遲緩的牠們，反而成為了鳳頭蒼鷹、領角鴞等城市猛禽最容易捕捉的獵物。毒素就這樣順著食物鏈，一層一層在生態系...
張貼留言
閱讀完整內容