AUG 18, 20268 分鐘閱讀Claude Code

101 BB 班 - Claude Code 到底是什麼,不寫程式也能用?

Claude Code 是一款直接裝在你電腦上的 AI 代理工具,不只寫程式的人用得著。這篇由零開始講解它是什麼、跟 claude.ai 有何分別、安全嗎、如何安裝,以及新手一定要懂的指令與 Context Window 觀念。

claude code 就是一款 “agentic coding tool“

什麼是 Claude Code

Claude Code 實際上其實就是一款 "agentic coding tool" - AI代理寫程式工具, 它直接安裝你的電腦上,能夠直接存取你的所有資料夾和你給它的工具。

它最早只有終端機版本,所以很多人以為要很懂命令列才碰得到。現在不是了。 例如開發人員經常用到的VS Code 跟 JetBrains 都有外掛,

VS Code 的 Claude Code 外掛
VS Code 的 Claude Code 外掛,安裝後可在編輯器側邊直接對話。
JetBrains IDE 的 Claude Code 外掛
JetBrains 系列的 IDE,在 Plugins 市集搜尋 Claude Code 即可安裝。

Claude自己的官方桌面版應用程式裡也有一個 Code 分頁,而 claude.ai/code 用瀏覽器就開得起來,手機也可以遠端接回你的電腦。終端機只是其中一種使用方法。

Claude Code 官方桌面版應用程式的 Code 分頁
官方桌面版應用程式的 Code 分頁,選一個資料夾即可開始。

但有一件事要先知道:免費的 claude.ai 帳號用不了 Claude Code。 你需要 Pro、Max、Team、Enterprise 其中一種訂閱,或者一個 Console 的 API 金鑰。

(看到這裡的香港讀者先別急著要關掉,現在其實有另一個方法讓你可以免訂閱,免VPN也能用到Claude Code,之後會另有一篇文章介紹,所以請繼續看完吧)

Claude Code 跟 Claude.ai 有什麼分別,為什麼要獨立出來

你在 claude.ai 打字,它只看得到你貼進去的東西。 而Claude Code 可以自己打開檔案來讀,自己在終端機跑指令,自己動手改檔案,改完再跑一次看有沒有壞掉。

模型會不會寫程式,這個問題兩年前就解決了。卡住你的是存取你電腦的屏障。

在 claude.ai 修一個錯誤的真實流程是這樣的:複製錯誤訊息貼進去,它問你那段程式長什麼樣,你去翻檔案複製貼上,它問你另一個檔案,你再貼一次,它給你一段修好的程式碼,你貼回去,跑,又錯,回到第一步。

八成的時間,你在當它的手和眼。

所以要獨立出來的東西不是模型,是直接讓模型長出手和眼。 而這件事長不到網頁上:瀏覽器讀不到你的硬碟,也跑不了你的指令。它必須是一個裝在你機器上的程式。

第二個理由是權限。網頁聊天最壞的結果是它講錯話。 但一個能跑指令的工具,最壞的結果是它直接刪掉你的東西。 這需要另一整套機制:哪些動作要先問你、哪些永遠不准、出事之後怎麼倒回去。

第三個理由是互動形態變了。Claude.ai 是問答,你問一句它答一句。 Claude Code 是代理:你講一次,它自己讀二十個檔案、跑八次指令、改四個檔案,直接完成工作。

Claude Code能做什麼,是不是只能寫程式?

絕對不是只有寫程式才能用。而且我會覺得它基本上能代替大部份claude.ai 的其他功能。

東西在檔案裡、動作是指令、結果看得出來對不對。符合這個形狀的工作,不管有沒有程式碼,它都做得動。

非程式的例子:把三十份試算表合併、清掉重複、輸出一份報表;讀一整個資料夾的會議紀錄,整理成摘要並標出誰答應了什麼;一堆檔案批次改名、按日期分資料夾;把筆記轉成網頁;寫一個每天早上自己跑的腳本。

即使你只是想找人討論、想寫文案、想看一張圖,那用 claude.ai 當然可以,你要開 Claude Code 也一樣可以。

至於那些完全不想碰終端機也不想管檔案的人,Anthropic 另外有一個叫 Cowork 的代理功能,那個是為非工程師做的。

Claude Code 安全嗎

安不安全,主要看幾點:

  1. 怎樣使用
  2. 在哪個資料夾用
  3. 你給的權限

它能改檔案、能跑指令,所以最壞的情況是它弄壞你今天的工作。但有一批系統設定檔它預設碰不到,環境本身不會被它搞爛。

有一件事很多中文教學還沒寫:在 Pro、Max、Team 方案上,它預設不會每一步都停下來問你要不要批准,而是由另一個模型在背後幫你審每個動作,攔掉明顯危險的操作。

替你把關的不是你,是另一個 AI。

聽起來嚇人,但這是刻意的。一直跳出來問,多數人按到第三十次就開始無腦按同意,那比不問更危險。

新手記兩條就夠:

在有版本控制(即是 git)的資料夾裡用它。出事的時候你才有得復原。

不要在桌面或家目錄這種什麼都有的地方開。它讀得到的範圍,就是它出事的範圍。

如何安裝

最簡單的方法就是直接安裝Claude的官方Desktop App,然後在Code分頁上使用。或者上 claude.ai/code

如果真的想裝在自己電腦上的,在Terminal跑指令的話,去官方安裝頁複製那一行指令就好。

https://code.claude.com/docs/en/quickstart

shell
curl -fsSL https://claude.ai/install.sh | bash
Claude Code 安裝成功的終端機畫面
安裝成功後,終端機會顯示版本與安裝位置。

確切的指令請跟從官方安裝頁,這一年改過好幾次。Windows 那邊尤其嚴重。

裝好之後,第一次的流程是這樣:

先在Terminal輸入以下 claude --version 驗證是否安裝成功

成功的話應該會看到類似 2.1.233 (Claude Code)

Claude Code 第一次啟動的登入選項
第一次啟動會要求選擇登入方式,使用訂閱帳號者選第一項。

然後可以進到你的專案資料夾,打 claude 開起來。先跑 /init,它會把整個專案掃一遍,生一份 CLAUDE.md。那是一個純文字檔,記著這個專案的規矩,之後每次開工它都會自動讀進去。然後才講你要它做的第一件事。

裝完如果哪裡不對,打 claude doctor,它會告訴你安裝方式、登入狀態、設定檔哪裡有問題。

要知道的使用技巧

幾個一定要懂得使用的指令

/init 初始化你的專案,生一份 CLAUDE.md,即是這個專案的指引和規範

/plan 進入計劃模式,在動工前給出一份詳細計劃

/context 看現在是什麼東西佔掉了記憶

/compact 壓縮對話,當對話太長,context已經超過一半時就可以使用

/clear 清空對話,完成某個特定任務後使用,避免污染下一輪對話

/permissions 看跟改權限規則

關於 Context Window

Context Window 概念示意圖

Context Window的限制其實不只是Claude Code獨有的機制,而是所有大語言模型都有的問題, 它的記憶有上限。一次工作階段裡面,系統提示、工具說明、CLAUDE.md、你們講過的每一句話、它讀過的每個檔案,全部擠在同一個空間。

滿了會怎樣:它開始忘記前面講過的規則,回答品質往下掉,而且不會跟你講。

Claude Code /context 指令的輸出畫面
輸入 /context 即可看到目前記憶被什麼佔用、還剩多少空間。

判準只有一條。換題目用 /clear,同一題講太長才用 /compact。 我通常是只要context過半就會用 /compact

Claude Code 執行 /compact 壓縮對話的畫面

新手最常見的做法是一個對話從早開到晚,中間換了五個題目都不清。那個對話到了下午的表現會明顯差過早上,而人通常會怪到模型頭上。

/clear 清掉的只有這次對話,CLAUDE.md 會重新讀進來,所以專案的規矩不會跟著掉。判斷什麼該寫進去也很簡單:同一句話你對它講到第三次,那句就該寫進檔案。

Claude Code的權限模式

一共六個:

模式它不用問就能做的事
手動只能讀
自動接受修改讀、改檔案、常見的檔案操作指令
計劃讀,以及被分類器放行的探索指令
自動幾乎全部,背景有安全檢查
不詢問只有你事先批准的工具
略過權限全部

Shift+Tab 中途切換,狀態列會顯示你現在在哪一格。

我本人是長開 bypass permissions,真正重要的東西我都會用hook來限制,再加上設好版本控制,出了什麼事也是我認為可控的風險。

總之就是按你對AI的認知和能承受的風險來設置吧。

寫在最後的注意事項

AI 有幻覺,AI 會做錯,AI 會給出很糟糕的提案,不論是多高階的模型。

它做錯的時候不會慌,語氣跟做對的時候一模一樣。這是新手最難適應的一點。

常見的錯法有幾種。

改了一個地方,順手改了三個你沒要它改的地方。

測試跑不過,它把測試改掉而不是把程式改對。

你講的需求它理解成另一件事,然後很有效率地把那件事做完了。

腦補出不存在的東西。

提出看起來很好,但行內人一看就知道有問題的方案。

三個習慣可以擋掉大部分:

一次一件事,做完就提交。

每次它改完,問一句「你改了哪幾個檔案,各自為什麼」。

看不懂那份計劃就不要批准。看不懂多數時候不代表你不夠聰明,代表那件事還沒被講清楚。

一直迫問它。

寫程式的話,善用 /review

總結Claude Code是很強大的工具,但就像蜘蛛俠裡面的對白:great power comes great responsibility, 記得你才是這工具的使用者,不要把思考外判。