精華筆記

· @aihub.tw

Claude 新手指南

Claude Code 入門:讓 AI 直接坐進你的專案幫你幹活

Claude Code 入門:讓 AI 直接坐進你的專案幫你幹活

前兩課,你都是打開瀏覽器、在 Claude.ai 的對話框裡跟它聊天:問問題、寫文案、改句子。它很強,但有個天花板——它看不到你電腦裡的東西。你要它幫你改一份程式碼,得先把整份貼進對話框;它給你改好的版本,你還得手動複製回去、貼對位置、存檔。檔案一多、專案一大,這種「人肉搬運」就變成惡夢。

這課要介紹的 Claude Code,就是來打破這個天花板的。它是一個跑在**終端機(terminal)**的工具,啟動之後,同一個 Claude 就從「隔著螢幕給你建議的顧問」,變成「坐進你電腦、直接動手改專案的工程師」——它讀得到你整個資料夾、能改檔案、能跑指令、能除錯,而且每一步動手前通常會先問你。這一課我們就從零把它裝起來、登入、跑完第一個任務。

這堂課適合誰 適合:想讓 AI 真的幫你「動手做事」而不只是聊天的人,特別是會碰到程式碼、專案檔案的人(工程師、想學寫程式的新手、常改設定檔的人)。需要基礎:零基礎 OK,但要會開終端機、會用 cd 切資料夾(不會也沒關係,本課會手把手帶)。前置課:第 1、2 課(怎麼跟 Claude 對話、怎麼把需求講清楚,這課全都用得上)。

這堂學什麼

  • 搞懂三種用法的差別:Claude 網頁 / App、Claude Code、Cowork 各是幹嘛的,你現在該用哪個
  • 從官方安裝器把 Claude Code 裝起來,登入、確認方案(這是付費功能,免費版不含)
  • 會選模型:Sonnet 5、Opus 4.8、Haiku 4.5 差在哪,什麼時候該切
  • 跑完你的第一個任務,看懂它「讀懂 → 提案 → 你確認 → 執行」的工作循環
  • 記住幾個一打就出來的內建指令(/init、/clear、/model 等)
  • 避開三個新手最常踩的坑,含實際會看到的錯誤訊息與解法

觀念一:同一個 Claude,三種用法

很多人以為「Claude」就是那個聊天網頁。其實在 2026 年,同一個 Claude 至少有三種身分,搞清楚差別你才知道什麼事該丟給誰:

同一個 Claude 的三種用法:網頁 App 像顧問、Claude Code 像工程師、Cowork 像跑雜事的代理

  • Claude 網頁 / App:就是你前兩課用的對話框。像會議室裡的顧問——你問它答,但要它看你的檔案,得自己複製貼上。
  • Claude Code:跑在終端機的工程師。它直接讀改你電腦上的整個專案、能執行指令、跑測試驗證。這課的主角。
  • Claude Cowork:2026 年推出、主打非工程師的代理。它幫你跑整理檔案、彙整報告、多步驟雜事這類日常知識工作,現在桌面、網頁、手機都能用(需要 Max 方案)。

一句話記住:網頁版給你答案,Claude Code 幫你把事情做完。 這一課,我們專心把 Claude Code 學會。

網頁版 vs Claude Code,到底差在哪

Claude.ai 網頁 / App Claude Code
在哪用 瀏覽器、手機 終端機、桌面 App、編輯器
看得到你的檔案嗎 不行,要你手動貼 能直接讀整個專案
能改檔案嗎 不行,只回你文字 能直接改,還能跑指令與測試
適合 聊天、寫作、問答 寫程式、重構、除錯、批次改檔

觀念二:它其實是個會自己動手的工程師

在動手安裝前,先建立一個正確的心智模型,你用起來才不會慌。Claude Code 不是「幫你打字的自動完成」,它比較像一個新來的工程師:你交代任務,它會自己去讀相關檔案、想清楚要怎麼做、提出方案、等你點頭,才真的動手。

Claude Code 的工作循環:讀懂、提案、你確認、執行四個步驟

這個「讀懂 → 提案 → 你確認 → 執行」的循環,是 Claude Code 最重要的觀念。破壞性的操作(刪檔案、改資料庫、把東西推上線)之前,它一定會停下來問你;而你的工作,就是像資深工程師 review 新人的 PR 一樣,看一眼再放行。第 2 課學的「把需求講清楚、給足背景」在這裡完全適用——講得越清楚,它一次到位的機率越高。

手把手實戰

以下每一步我都會給你能直接複製的指令。跟著做,大概十分鐘就能跑出第一個任務。

第一步:安裝 Claude Code

現在官方推薦用原生安裝器,不需要先裝一堆東西。打開終端機,依你的系統貼上對應指令:

macOS / Linux / WSL:

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

Windows(PowerShell):

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

原生安裝器會自己在背景更新,最省事。如果你本來就有 Node.js 環境,也可以用 npm 裝(需要 Node.js 22 以上):npm install -g @anthropic-ai/claude-code。裝完後,用 claude --version 確認裝好了。

第二步:進到你的專案資料夾

Claude Code 是「以資料夾為單位」在工作的。用 cd 切到你要處理的專案:

cd ~/my-project

如果你現在還沒有專案,先隨便建一個空資料夾練習也行:mkdir ~/claude-test && cd ~/claude-test。重點是——你在哪個資料夾啟動,它就看得到那個資料夾裡的所有東西。

第三步:啟動並登入

在專案資料夾裡直接輸入:

claude

第一次啟動會引導你登入,通常會開瀏覽器讓你授權一次。注意:Claude Code 是付費功能,需要 Pro、Max、Team 或 Enterprise 方案,免費版的 Claude.ai 不含 Claude Code。 方案怎麼選下面會講。登入完成後,你就進到 Claude Code 的對話介面了,只是它現在「看得到」這個資料夾。

第四步:選對模型

進去之後,先花十秒鐘搞懂「模型」這件事。在對話中打 /model 就能切換:

Claude Code 模型選擇:Sonnet 5 是預設又快、Opus 4.8 最聰明留給難題、Haiku 4.5 最便宜

  • Sonnet 5——目前 Claude Code 的預設模型,又快又夠聰明,原生支援超長脈絡,多數日常任務用它就好。
  • Opus 4.8——最聰明的模型,留給複雜架構、大重構、難纏的 bug。打 /model opus 切過去。
  • Haiku 4.5——最便宜最快,適合簡單小任務、想省用量時用。

新手建議:先用預設的 Sonnet 5,遇到它搞不定的難題再切 Opus 4.8。 越聰明的模型吃越多用量,別一開始就開最大。

第五步:用中文下你的第一個任務

不用學什麼特殊語法,直接用自然語言講你要什麼。試試這幾句:

> 這個專案是做什麼的?幫我看一下整體架構

> 幫我在 README 加一段「安裝步驟」

> utils/date.js 有一個 bug,日期格式化在跨月時會錯,幫我找出來並修好

Claude Code 會自己去讀相關檔案、提出修改、問你要不要套用。你會看到它一步步「讀了哪些檔、打算改什麼」,確認沒問題再讓它動手。

關鍵心法把它當一個能力很強、但需要你交代清楚的新進工程師:講清楚要什麼、給足背景(第 2 課的原則在這裡一樣適用),它做完你review 一下再放行。你才是最後把關的人。

一打「/」就跳出來的常用指令

在 Claude Code 對話中輸入 /,會跳出一整排內建指令。新手先記這幾個就夠:

Claude Code 常用內建指令:/init、/clear、/compact、/model、/review、/help

  • /init——讓它讀完整個專案,產生一份專案說明檔 CLAUDE.md(這是下一課的主題,先知道有這東西)。
  • /clear——清空對話、開新話題,避免舊脈絡干擾新任務。任務切換時很好用。
  • /compact——對話太長時把它壓縮、保留重點,讓它「記得住」前面。
  • /model——切換模型,就是上面第四步教的。
  • /review——請它幫你 code review 這次的改動。
  • /help——看說明與所有指令清單。

各方案怎麼選

既然 Claude Code 是付費功能,順便看一下 2026 年 7 月的方案。個人用戶主要在 Pro 和 Max 之間選:

Claude 各方案與 Claude Code 可用性:免費版不含、Pro US$20、Max 5x US$100、Max 20x US$200

  • 免費版:不含 Claude Code,只能用網頁聊天。
  • Pro(US$20 / 月):個人入門,含 Claude Code,輕度使用夠用。
  • Max 5x(US$100 / 月):用量約 Pro 的 5 倍,適合每天都在用的重度使用者。
  • Max 20x(US$200 / 月):用量約 Pro 的 20 倍,還含 Cowork。

先從 Pro 開始就好,不夠用再升。價格以官方 claude.com/pricing 為準。

它很擅長什麼、你要盯什麼

Claude Code 很擅長讀懂專案改多檔寫測試,你要盯緊破壞性操作與金鑰安全

很擅長:讀懂陌生專案、一次改多個檔案、寫測試、除錯、重構老程式、幫你產生 git commit 訊息。這些原本要花你半天的事,它幾分鐘就有初稿。

你要盯緊:破壞性操作(刪檔、改資料庫、推上線)一定自己看過再放行;別把密碼、API 金鑰貼進對話;複雜需求先講清楚背景;做完自己 review。它會盡量先問你,但你才是最後那道關。

常見坑

坑 1:輸入 claude 後出現 command not found: claude

這代表安裝沒成功,或終端機還沒認到新裝的指令。先關掉終端機視窗、重開一個再試一次(安裝器改了環境變數,舊視窗讀不到)。還是不行的話,跑 claude doctor 讓它自我診斷,或重跑一次第一步的安裝指令。用 npm 裝的人特別注意:官方現在建議用原生安裝器,npm 版本需要 Node.js 22 以上,版本太舊會出問題。

坑 2:登入後跳出「需要付費方案」之類的訊息,進不去

Claude Code 不含在免費方案裡。如果你只註冊了免費的 Claude.ai,登入會被擋。解法:到 claude.com 升級到 Pro(US$20 / 月)或以上,再回來跑 claude 登入。這不是 bug,是它本來就需要付費方案。

坑 3:它想改一個你沒預期的檔案、或動作太大

Claude Code 動手前通常會停下來問你「要不要套用這個修改」。看到不對就直接拒絕、或打字糾正它,例如「先不要動 config,只改 utils/date.js」。它會照你的話重來。千萬不要無腦一路按同意——尤其是刪檔、跑 rm、git push 這類指令。真的手滑改壞了,如果你的專案有用 git,git status 和 git restore 就是你的後悔藥(git 的用法屬於進階主題,先知道「有救」即可)。

坑 4:它「忘記」前面講過的事,或回答開始跳針

同一個對話開太久、塞太多內容,它的記憶會被稀釋。兩個解法:換新任務時用 /clear 清空重來;同一個任務但對話很長,用 /compact 把歷史壓縮、保留重點。養成「一個任務一段乾淨對話」的習慣,品質會穩很多。

作業

  1. 把 Claude Code 裝起來並跑一次:用官方安裝器裝好,cd 到任一個資料夾,claude 啟動登入,然後問它「這個資料夾裡有什麼?幫我簡單介紹」。看它怎麼讀你的檔案。
  2. 練習切模型:在對話中打 /model,把三個模型都看過一遍,切到 Opus 4.8 再切回 Sonnet 5,感受一下差別。
  3. 跑一個真的改檔任務:找一個檔案(或新建一個 test.txt),請 Claude Code 幫你改點東西,重點是在它動手前看清楚它要改什麼,練習「確認再放行」這個動作。
  4. 踩一次坑再爬起來:故意開一段很長的對話,再用 /clear 開新話題,體會脈絡乾淨的差別。

下一課預告

你有沒有發現一件煩事:每次啟動 Claude Code,它都得重新認識你的專案一次——你用什麼框架、有什麼慣例、常用哪些指令,全都要重講。很浪費時間,也容易講漏。

有沒有辦法讓它「記住」這個專案的規矩?有——就是這一課提過好幾次的 CLAUDE.md。第 4 課,我們就來寫這份「專案記憶」:一個放在專案根目錄的檔案,Claude Code 每次啟動都會先讀它,從此不用再重複交代。寫好一次,之後每次它都更懂你的專案。

#Claude 新手指南#Claude Code#終端機#AI 工程助手

← 回所有文章