Claude Code 教學與實戰指南：從安裝、指令到專案工作流（2026）

最後更新：2026-03-29

先說結論：Claude Code 值得學嗎？

值得，但前提是你知道自己在看什麼、也願意驗收它做了什麼。

Claude Code 不是把 Claude 搬進終端機而已。它真正有差的地方是：它可以直接進你的專案目錄，讀檔、找檔、改檔、跑命令、查 diff、接工具，甚至把一段本來很散的工程流程收成一個可重複的工作流。

這也是它和聊天版 Claude 最大的差異。聊天版比較像你把一段程式貼進去問意見；Claude Code 比較像你把一個懂 repo 的技術助理叫進工作台，讓他跟你一起看專案、一起拆問題、一起動手。

但如果你現在連 git、shell、測試、權限都還不熟，Claude Code 不會幫你跳過基礎。它只會把你的速度放大，也把你的判斷失誤放大。這點其實和 努力也會通膨：AI 時代，軟體工程師為什麼不能只會寫 code？ 講的是同一件事：AI 讓輸出更便宜，但真正稀缺的還是選擇、拆解與驗收能力。

如果你要一句最短答案，我會這樣說：

• 你常在 terminal 工作、會看 repo、會自己驗收改動：很值得學。
• 你只想要一個會幫你補幾行程式的聊天工具：先不用急著上 Claude Code。

如果你已經確定要把 Claude Code 放進日常工作流，這篇主文先看完，再按需求往下延伸會最順：

• 想用手機和 Telegram 接手本機 session，看 Claude Code Telegram 教學：用官方 Channels 從手機操作本機專案（2026）
• 想從手機或瀏覽器直接接續正在跑的工作，看 Claude Code Remote Control 教學：怎麼從手機延續本機 session（2026）
• 想把 @claude 接進 issue 和 PR，看 Claude Code GitHub Actions 教學：怎麼讓 @claude 幫你處理 issue 和 PR（2026）
• 想先把權限設穩，再看 Claude Code 權限怎麼設？permission modes、allowlist 與安全設定完整整理（2026）
• 想跟 Cursor 比較，再看 Claude Code vs Cursor：2026 AI Coding Agent 怎麼選

Claude Code 是什麼？和 Claude 聊天版差在哪？

短答：Claude Code 是 Anthropic 的 terminal-native coding agent。

這句話拆開來看，有三個關鍵。

1. 它不是單純問答，而是直接在專案裡工作

聊天版 Claude 的工作方式很單純：你貼內容，它回答案。

Claude Code 不一樣。它可以直接在你目前的專案目錄裡：

• 讀檔與搜尋
• 理解目錄結構
• 修改檔案
• 執行 shell 指令
• 看測試結果
• 連到 MCP 工具或外部整合

這代表它處理的，不只是「這段 code 怎麼寫」，而是「這個問題在整個專案裡應該怎麼處理」。

2. 它吃的是真實上下文，不是你手動貼的上下文

很多人第一次用 Claude Code 會有一種很明顯的感受：它終於不是一直叫你貼檔案了。

你不用再把 5 個檔案 copy paste 到聊天視窗。它可以自己去找。這種差別很像你在公司交接工作，一種是你每次都得把所有背景重講一遍，另一種是對方真的可以打開共用資料夾自己查。

3. 它比較像工作流工具，不只是生成工具

真正有價值的地方，不是它多會生 code，而是它可以把下面這整段流程串起來：

1. 理解專案
2. 找出可能相關的檔案與資料流
3. 提出最小修改方案
4. 動手改
5. 驗證結果
6. 補測試或做第二層 review

這種「從理解到驗收」的能力，才是 Claude Code 會讓工程師有感的地方。

Claude Code 和聊天版 Claude 的差異

如果你只是想問「這段程式哪裡怪」，聊天版就夠了。
如果你想讓 AI 幫你進 repo 找問題、收斂修改範圍、補測試，Claude Code 才是對的工具。

Claude Code 適合誰？先看你是不是這 3 種使用者

Claude Code 不是每個人都會覺得順。

1. 工程師

這是最適合的一群。

你會最常拿它做這些事：

• 讀陌生 repo
• 找 bug 相關檔案
• 先產一版最小修補
• 補 regression test
• 在 commit 前做第二層 review

如果你平常就有看 diff、跑測試、判斷架構的習慣，Claude Code 會直接幫你省掉很多體力活。

2. 技術 PM、創業者、接案者

也很適合，但前提是你看得懂改動，也敢否決錯的方向。

你會常用在：

• 快速讀懂現有專案
• 先拆工作與風險
• 驗證功能想法
• 先做出骨架，再交給工程師收尾

這類使用者最大的好處不是自己變成工程師，而是你終於能更快看懂工程語境。

3. 願意學 terminal 的非工程背景使用者

可以用，但不建議當第一個 AI coding 工具。

原因很實際。Claude Code 的強，建立在你至少知道下面這些東西是什麼：

• 你現在在哪個目錄
• 哪些檔案能改、哪些不該碰
• git diff 在看什麼
• 指令執行之後代表什麼
• 測試失敗時該回頭看哪裡

如果這些還很陌生，先從 GUI 型工具或小範圍任務開始，會比較穩。

Claude Code 怎麼安裝？登入、系統需求與基本設定

根據 Claude Code Docs 目前的說明，基本需求大致是：

• macOS、Ubuntu / Debian，或 Windows 搭配 WSL
• Node.js 18+
• 網路連線
• 已登入 claude.ai 帳號

Step 1：安裝 Claude Code

最常見的安裝方式是：

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

不要第一時間就用 sudo 硬裝。
如果你一裝就碰到權限問題，先回頭修 Node / npm 的安裝方式，否則你之後很容易在系統層權限上繼續踩雷。

Step 2：進到專案目錄，啟動 Claude Code

cd your-project
claude

第一次進來時，通常會碰到登入、工作區信任與基本設定。

Step 3：先完成登入與工作區信任

依目前官方文件，像 Remote Control、Channels 這類功能都需要用 claude.ai 帳號登入，不能只靠 API key。

所以你至少要先確認這兩件事：

1. 你已經成功登入 claude.ai 帳號
2. 你在這個專案裡至少跑過一次 Claude Code，接受過 workspace trust

這一步很像你第一次進公司內網。你得先證明你是誰，也先表明你信任這個工作區。

Step 4：不要一進 repo 就叫它改檔

第一次進專案，最穩的做法不是「幫我修這個 bug」，而是：

先不要修改任何檔案。先讀專案結構，告訴我：
1. app 入口在哪
2. API、UI、config 分別在哪
3. 跟這個功能最相關的檔案有哪些
4. 你會先檢查哪幾個點

先讓它理解，再讓它動手。
這一步會直接影響你後面一整段工作的穩定度。

Step 5：設定檔要放哪裡？

Claude Code 現在會讀專案和使用者層設定。實務上你至少會碰到這幾種東西：

• ~/.claude/...：你的使用者層設定
• .claude/...：專案共用設定
• CLAUDE.md：專案工作規則、慣例、風格指引

如果你有團隊，建議把「大家都要遵守的規則」放進專案層；把你自己的偏好、本機路徑或權限細節放在使用者層。

這樣你不會把私人環境設定硬塞進 repo，也不會讓每個人重複講一遍團隊慣例。

Claude Code 常用指令整理：新手先熟這幾個就夠

很多人一開始最容易被嚇到，因為 Claude Code 功能很多，文件也多。

但你真的不用第一天就把全部學完。
先熟這幾個，已經夠你上手。

如果你剛起步，我建議的學習順序是：

1. 能安裝
2. 能進 repo
3. 能讀結構
4. 能做最小修改
5. 能驗證
6. 再碰進階整合

比起死背指令，更重要的是你知道現在在哪個階段。

Claude Code 權限怎麼看？為什麼一直跳 permissions？

這是新手最常卡的地方。2026 年官方也把 permission modes 做得更明確了。

先講結論：一直跳權限，不代表它壞了

Claude Code 不是只是回你一段文字，它可能真的去做這些事：

• 讀檔
• 編輯檔案
• 執行 shell 指令
• 發出網路請求
• 呼叫 MCP 或其他工具

所以它一定要有權限模型，不可能像聊天工具一樣什麼都不問。

現在有哪些 permission modes？

依 Claude Code Docs 目前的說明，常見模式大致如下：

新手最常見的錯誤：一開始就想把所有提示關掉

這很像你剛租屋，第一天就把家裡鑰匙整串交給剛認識的人，因為你嫌每次開門太麻煩。

短期很省事，長期很危險。

比較穩的做法是：

• 剛開始用 default 或 plan
• 確認它理解方向後，再切 acceptEdits
• 你真的知道環境是隔離的，再考慮更開放的模式

Plan mode 很值得先學

如果你還不確定 Claude Code 會不會走歪，plan 很好用。

它的價值不在於幫你省一步，而是幫你把「先理解，再動手」變成一個預設流程。

例如你可以直接這樣用：

claude --permission-mode plan

或直接在對話裡先要求它只做規劃。

對多檔案修改、陌生 repo、架構變動來說，這比一開始就讓它改安全很多。

Auto mode 值不值得開？

目前官方把 auto mode 定位成減少 prompt fatigue 的方式。它不是完全無腦放權，而是用額外的安全檢查去判斷某個動作是否超出你的任務範圍。

但它不是「安全保證」。
比較準確的理解是：它比 bypassPermissions 穩，但還是不能取代你的 review。

如果你現在還在熟悉 Claude Code，我不建議第一天就開 auto mode。
先把 plan -> acceptEdits -> review 這條基本路走順，再去碰更高自主權的模式。

Claude Code 實戰 SOP：我會怎麼讓它讀 repo、修 bug、補測試

真正讓 Claude Code 發揮價值的，不是你問得多花，而是你工作流有沒有收好。

下面這條 SOP，是我認為大多數人最容易穩定複製的做法。

階段 1：先理解，不要急著改

第一輪只做三件事：

1. 找相關檔案
2. 解釋判斷依據
3. 禁止修改

示例：

先不要改檔。請先找出和這個 bug 最相關的檔案、函式、資料流。
告訴我你的判斷依據，並列出你會先檢查的 3 個點。

這一步很重要。
因為只要理解階段走歪，後面整串修改都會歪。

階段 2：縮小修改範圍

等它理解完，再要求最小方案：

根據你剛剛的分析，請提出最小修改方案。
限制：
1. 只改必要檔案
2. 不做順手重構
3. 先說明風險，再動手

這樣可以避免它進入那種「順便幫你整理整個專案」的模式。

階段 3：改完立刻驗證

不要只因為它說 done 就相信它真的 done。

至少做這幾件事：

• 看 diff
• 跑測試
• 看有沒有新 warning
• 叫它再 review 一次剛剛的變更

如果是重要改動，我甚至會直接補一句：

請用 reviewer 的角度檢查你剛剛的修改，列出 3 個最可能的風險。

階段 4：讓它補測試，但不要把測試策略整包外包

Claude Code 很適合幫你補：

• 單元測試骨架
• 邊界條件測試
• regression test

但你還是要自己判斷：

• 這個 bug 真正應該驗證什麼
• 測試命名是否準確
• 它是不是只是把現在的 bug 行為寫死

最適合先交給 Claude Code 的任務

Claude Code 的進階用法：Remote Control、Telegram Channels、GitHub Actions

這一段先講結論：Claude Code 現在已經不只是 terminal 裡單機使用。

2026 年很值得注意的三條線是：

1. Remote Control
2. Channels
3. GitHub Actions

這三條線會直接決定你未來怎麼把 Claude Code 接進真實工作流。

1. Remote Control：離開電腦後，從手機接著做

官方現在已經有 Remote Control。
你可以讓本機正在跑的 Claude Code session，從手機、平板或瀏覽器接著操作。

如果你想直接看完整操作流程、錯誤排查和 claude.ai/code 的差異，可以接著讀 Claude Code Remote Control 教學：怎麼從手機延續本機 session（2026）。

這個功能的意思不是「把你的專案丟上雲端」，而是你的本機 session 繼續在你自己的機器上跑，手機只是接進來看和操作。

對很常離開座位的人，這很實用。你可以在外面先回一句指令、看它的進度、決定下一步，不用每次都等回到電腦前。

2. Channels：把 Telegram、Discord、iMessage 直接推進 Claude Code

這條線是現在最值得追的。

官方文件已經明寫支援 Telegram、Discord、iMessage 的 channels。
這代表你可以讓 Claude Code 不是只待在 terminal，而是從外部訊息直接把事件推進你目前的 session。

如果你特別想用 Telegram 操作 Claude Code，現在已經不是只能靠社群 hack。官方研究預覽裡就有 Telegram plugin。

這條線後面很值得拆系列文，因為它會延伸到：

• BotFather 建 bot
• pairing
• allowlist
• permission relay
• 手機操作本機 repo

如果你要做的是 Telegram 這一條，我已經另外拆成完整實作文：Claude Code Telegram 教學：用官方 Channels 從手機操作本機專案（2026）。

3. GitHub Actions：讓 Claude 在 PR / Issue 裡工作

官方也已經有 Claude Code GitHub Actions。

最直觀的用法是：你在 PR 或 issue 裡提 @claude，讓它分析、修補、甚至協助產 PR。

這不等於你本機就沒用了。
比較合理的分工會是：

• 本機 Claude Code：讀 repo、理解、修 bug、實驗
• GitHub Actions：PR 流程、自動 review、團隊協作

如果你是接案者或小團隊，這條線很值得後續再拆。

如果你現在就想把 @claude 接進 GitHub 流程，直接看 Claude Code GitHub Actions 教學：怎麼讓 @claude 幫你處理 issue 和 PR（2026） 會比較快。

Claude Code 和 Cursor、Windsurf 怎麼選？

這題不要只看誰比較強，要看你平常在哪裡工作。

快速結論

• 你是 terminal 派：先看 Claude Code
• 你整天待在 IDE 裡：Cursor 或 Windsurf 通常更順
• 你想讓 agent 幫你處理多步驟任務：Claude Code 很有優勢
• 你要的是編輯器裡即時補全、邊寫邊改：IDE 類工具通常更直覺

三者比較

如果你只能先學一個，怎麼選？

我會這樣分：

• 你每天都開 terminal：先學 Claude Code
• 你幾乎都待在 IDE：先學 Cursor 或 Windsurf
• 你是接案者、小團隊、技術 PM：Claude Code 對讀 repo、任務拆解、review 很有幫助
• 你還在建立驗收能力：先選你比較敢看 diff、敢看結果的工具

不要追最酷的，先追你最敢驗收的。

Claude Code 常見問題 FAQ

Claude Code 要付費嗎？

基本上要有對應帳號與可用方案。像 Remote Control、Channels 這類功能，現在都要求 claude.ai 登入，不是單靠 API key 就能全開。

Claude Code 怎麼安裝？

最常見的方式是：

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

前提是本機已有 Node.js 18 以上版本。

Claude Code 為什麼一直跳 permissions？

因為它不是純聊天工具，而是真的會碰檔案、命令與外部工具。比較穩的做法不是一次全放行，而是先從 default 或 plan 開始，再逐步放寬。

如果你最近最煩的就是權限提示、allowlist 和 auto mode，建議直接讀 Claude Code 權限怎麼設？permission modes、allowlist 與安全設定完整整理（2026）。

Claude Code 適合非工程師嗎？

可以，但不推薦當第一個 AI coding 工具。你至少要看得懂目錄、git diff、測試與 shell 指令，不然很難驗收它做的事。

Claude Code 可以用 Telegram 操作嗎？

可以。依目前官方文件，Channels 的研究預覽已包含 Telegram plugin。不過這條線比較適合另外拆成完整教學，因為還會牽到 bot 設定、配對、allowlist 與權限轉發。

Claude Code 跟 Cursor、Windsurf 差在哪？

最大的差異不只是模型，而是工作位置。Claude Code 偏 terminal-native agent；Cursor、Windsurf 偏 IDE 內協作。你平常在哪裡工作，通常就決定了哪個工具更順。

如果你現在只想先釐清 Claude Code 和 Cursor 到底怎麼選，直接跳到 Claude Code vs Cursor：2026 AI Coding Agent 怎麼選。

下一步行動：先做第一個可驗收流程，不要一開始就追滿配

如果你今天剛接觸 Claude Code，我建議你照這個順序走：

1. 安裝並成功進入一個測試 repo
2. 只請它做「讀結構」與「找相關檔案」
3. 再做一個小 bug 修補
4. 改完看 diff、跑測試、再 review 一次
5. 最後才開始碰 Remote Control、Telegram、GitHub Actions

只要你一開始就把目標設成「讓它懂我整個系統，順便幫我全部改好」，大多都會失敗。

比較穩的方式，是先把 Claude Code 當成一個很強的技術助理，而不是一個可以直接接手專案的替身。

你先把第一個可驗收流程走通，後面再談自動化，會輕鬆很多。

參考來源

資料最後查核日期：2026-03-29

• Claude Code Docs: Choose a permission mode
• Claude Code Docs: Remote Control
• Claude Code Docs: Channels
• Claude Code Docs: Channels reference
• Claude Code Docs: GitHub Actions
• Anthropic: Introducing Claude Sonnet 4.6