如何在10分鐘內安裝Claude Code（即使你從未接觸過終端）

如果你被告知 如何安裝 Claude Code 認為只有開發者才能使用 Claude Code 是行不通的？本指南將改變你的看法。 Claude Code 是 Anthropic 公司開發的 AI 代碼代理，它就駐留在你的終端中——儘管名字裡有「代碼」二字，但你並不需要成為程式設計師才能運行它。你只需要安裝一次，而這正是我們接下來要做的：一個簡單易懂、通俗易懂的教程，只需大約十分鐘即可完成，即使你以前從未打開過終端也能輕鬆上手。.

我使用 Claude Code 管理十多家自主營運的企業，而大多數個人創業家要想獲得首次自動化成功，最大的障礙並非天賦，而是安裝。因此，我們將掃清這道障礙。讀完本文後，您將在 Mac 或 Windows 電腦上安裝好 Claude Code，修復幾乎所有新手都會遇到的四個錯誤，並將其應用於實際業務任務，而不是僅運行一個「Hello World」演示程式。.

安裝 Claude Code 之前：你需要什麼（以及不需要什麼）

我們先來撥開迷霧，因為大多數安裝指南都假設你已經了解其中一半術語的含義。以下是安裝 Claude Code 之前你需要了解的內容清單——以及同樣重要的，你可以忽略的內容。.

你需要三樣東西：

• 運行 macOS、Windows 或 Linux 系統的電腦。. 過去五年內的任何版本都可以。 Claude Code 是一個輕量級的命令列工具，而不是大型程式——它不會拖慢你的電腦速度。.
• 終端。. 這是純文字窗口，您可以在其中輸入命令。您的 Mac 上已經有一個名為「純文字視窗」的視窗。 終端. 在 Windows 系統上，我們將使用名為 WSL 的工具，我會一步步引導你完成操作。不要被它嚇到——終端其實就是一個執行指令的文字方塊。.
• 克勞德的帳戶。. 訂閱 Claude Pro 或 Max 是使用 Claude Code 的最簡單方法，當然，如果您喜歡按使用量計費，也可以連接 Anthropic API 金鑰。如果您正在考慮成本，請閱讀我們的成本明細。 Claude Code 是否免費，以及它對自僱人士來說究竟需要多少成本 在你做出決定之前。.

你不需要以下這些東西： 你不需要任何程式設計基礎、進階程式碼編輯器、GitHub 帳號或命令列經驗。你無需先「學習程式設計」。 Claude Code 會撰寫和編輯文件；你的任務是用簡單易懂的語言描述你的需求。.

有一項技術要求至關重要，也是初學者最容易忽略的：如果您使用 Node 方法（最常見的方法）進行安裝，則需要 Node.js 版本 18 或更高版本. 我們會檢查並一起安裝——絕不猜測。.

訂閱還是 API 金鑰——新手該選擇哪一個？

您第一次登入時就會面臨這個問題，所以我們現在就來解決。如果您已經付費使用 Claude Pro 或 Max，那麼使用該帳號登入是明智之選：每月費用固定，無需任何配置。如果您更傾向於按需付費，Anthropic API 金鑰則按令牌計費。對於大多數剛起步的自僱者來說，訂閱模式更加輕鬆——您可以自由嘗試，無需擔心費用。您以後隨時可以切換；兩種模式的安裝過程完全相同。.

如何在Mac上安裝Claude Code（逐步指南）

Mac 系統是最方便的途徑，所以我們就從這裡開始。打開 終端 - 按 Cmd + 空格, 輸入“終端”，然後按回車鍵。現在你就能看到我們需要的文字視窗了。.

步驟 1 — 檢查 Node.js。. 輸入以下內容並按下回車鍵：

node --version

如果你看到類似這樣的內容 v20.11.0 （任何 18 或更高的數字），您就準備好了——跳到步驟 3。如果您看到 命令未找到, 首先，你需要Node.js。.

步驟 2 — 安裝 Node.js（僅在需要時安裝）。. 最友善的方式是安裝 來自官方網站的 Node.js — 下載「LTS」版本，然後像執行普通應用程式一樣執行安裝程式。喜歡使用終端？如果您已經安裝了 Homebrew，請運行 brew install node. 無論哪種方式，完成後關閉並重新開啟終端，然後運行 node --version 再次確認。.

步驟 3 — 安裝 Claude Code。. 這是執行真正工作的單一命令：

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

這 -g 這意味著“全域安裝”，這樣你就可以從任何資料夾運行它。稍等三十秒。當文字停止捲動並重新出現提示符號時，Claude Code 就安裝完成了。.

第四步－確認是否成功。. 類型：

克勞德--版本

版本號表示成功。如果出現其他錯誤，則表示失敗。 命令未找到, 別慌——這是最常見的問題，我們會在下面的錯誤部分修復它。想完全跳過 Node？ Anthropic 也提供了一個原生安裝程序，您可以直接執行。 curl -fsSL https://claude.ai/install.sh | bash, 它會直接下載 Claude Code，而無需使用 npm。兩條路徑最終都指向同一個地方。.

如何在 Windows 上安裝 Claude Code（WSL，簡易方法）

Windows 系統多了一個步驟，但一旦掌握了技巧，其實非常簡單。 Claude Code 在以下環境中運作效果最佳： 世界超級聯賽 ——Windows 子系統 Linux 版 (WSL)。聽起來很嚇人，其實不然。 WSL 是微軟官方推出的免費功能，它為 Windows 提供了一個簡潔易用的 Linux 終端機。你可以把它想像成家裡一個乾淨整潔的工作間，裡面的工具都可以直接使用。.

步驟 1 — 啟用 WSL。. 開啟“開始”選單，鍵入“PowerShell”，右鍵並選擇“PowerShell”。 以管理員身份執行. 在藍色視窗中，輸入：

wsl --install

按下回車鍵。 Windows 將為您下載並安裝 Ubuntu（Linux 的版本）。安裝完成後，, 重新啟動電腦 ——這一部分很重要。.

步驟 2 — 開啟你的新 Linux 終端機。. 重新啟動後，打開“開始”功能表並啟動“Ubuntu”。首次啟動時，系統會提示您建立使用者名稱和密碼。這與您的 Windows 登入資訊不同——請選擇一個簡單的使用者名稱和密碼並記下來。現在您已經擁有一個完整的終端。.

步驟 3 — 在 WSL 中安裝 Node.js。. 請將這兩行程式碼依序貼上：

sudo apt update sudo apt install -y nodejs npm

它會要求輸入你剛剛創建的密碼。輸入密碼後螢幕上不會顯示任何內容——這是正常現象，只需輸入密碼並按回車鍵即可。.

步驟 4 — 安裝 Claude Code。. 與 Mac 上的命令相同：

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

然後確認 克勞德--版本. 好了，現在你的 Windows 系統上已經可以執行 Claude Code 了。如果你想在深入了解之前先了解這個工具到底是什麼，請參閱我們的… Claude Code CLI 操作員指南 解釋瞭如何像使用商業工具一樣使用它，而不僅僅是把它當作一個程式設計玩具。.

新手常遇到的 4 個安裝錯誤——以及精準的解決方法

90% 的「我無法安裝 Claude Code」案例都歸結為以下四個錯誤。這些錯誤並不意味著您操作有誤——它們只是首次安裝過程中正常的卡頓。以下列出每個錯誤及其對應的解決方法。.

錯誤 1：「node: 指令未找到」或版本低於 18

這意味著 Node.js 缺失或版本過舊。請返回並從官方網站（Mac）安裝最新的 Node.js LTS 版本，或執行以下命令。 sudo apt install -y nodejs npm （WSL）。之後關閉並重新開啟終端，以便它識別新版本，然後確認。 node --version.

錯誤 2：成功安裝後出現「claude：指令未找到」錯誤

令人沮喪，因為安裝 看起來 好像成功了。原因幾乎總是你的終端還找不到 npm 放置程式的位置（「路徑」問題）。快速解決方法：完全關閉終端窗口，然後打開一個新的終端機窗口，再試一次。 克勞德--版本 再試一次。十有八九這樣就能解決問題，因為新視窗會重新載入你的設定。.

安裝過程中出現錯誤 3：“EACCES：權限被拒絕”

這是 npm 報錯，提示無法寫入受保護的資料夾。. 不要透過添加以下程式碼來修復此問題： sudo 在命令前面 ——但這會在以後造成更嚴重的問題。徹底的解決方法是透過版本管理器安裝 Node，例如 算了, 這樣一來，所有內容都會保留在你的使用者資料夾中，npm 在該資料夾中擁有寫入權限。安裝 nvm，用它來安裝 Node，然後重新執行 Claude Code 的安裝指令，這次不要設定任何參數。 sudo.

錯誤 4：Windows 系統上所有功能均無法運作－因為您跳過了 WSL。

如果您嘗試在純 PowerShell 或命令提示字元中安裝但遇到問題，這就是您的問題所在。請返回 Windows 部分，安裝 WSL，然後在 WSL 中執行所有程式。 Ubuntu 改用終端。這一步就能解決大部分 Windows 安裝問題。.

遇到這裡沒有列出的問題？複製完整的錯誤訊息並貼上到搜尋框中——但說實話，一旦 Claude Code 運行起來，你就可以直接貼上錯誤訊息了。 它 並用淺顯易懂的語言解釋它們。這才是關鍵所在。.

您的首次登入和首次會話

安裝並確認無誤？現在讓我們正式啟動它。第一次啟動是見證奇蹟的時刻。.

步驟 1 — 建立一個工作資料夾。. Claude Code 在一個資料夾（「專案」）中運行。創建一個簡單的項目並進入其中：

mkdir my-first-project cd my-first-project

步驟 2 — 啟動 Claude Code。. 輸入那個開啟一切的字：

克勞德

步驟 3 — 登入。. 首次使用時，Claude Code 會開啟您的瀏覽器，並要求您登入 Claude 帳戶（或貼上 API 金鑰）。確認後，瀏覽器會自動將連線返回您的終端。您只需執行一次此操作——之後，Claude Code 就會記住您。.

第四步－用心打招呼。. 你會看到一個提示。請用簡潔明了的英文輸入一條實際的指令，例如： “請建立一個名為 notes.txt 的文件，並寫下三個歡迎郵件的寫作思路。” 觀看 Claude Code 的思考過程，它會提出更改方案，並在寫入任何內容之前徵求您的批准。這個核准步驟就是您的安全網－未經您的同意，您的文件不會有任何變更。如果您希望隨著業務的成長進一步加強這種安全性，請參閱我們的指南。 克勞德代碼鉤子 展示了運營商如何為代理的操作設定限制。.

這就是一個完整的流程：你提出請求，它執行操作，你批准。你之後使用 Claude Code 所做的一切都是這個循環的更豐富版本。.

首先要建構的是（一項業務任務，而非程式碼演示）

大多數教程都止步於“Hello World”，而這正是為什麼新手安裝 Claude Code 後就再也不碰它的原因——他們從未見過它有什麼實際用途。所以，讓我們打破這種模式。你的第一個專案應該是與你實際業務相關的、規模較小的實際任務。這裡有一個很棒的入門範例，幾乎適用於所有自僱人士。.

任務：將雜亂無章的文件資料夾整理成一個有條理、按日期排序的檔案。. 我們大多數人的「下載」資料夾裡都堆滿了發票、收據和PDF文件。用Claude Code軟體掃描一下，然後說：

“「請查看此資料夾中的文件。編寫一個小腳本，將每個 PDF 文件重命名，使其包含日期和簡短描述，然後按月份將它們分類到不同的子資料夾中。運行腳本之前，請解釋其功能，並在修改之前徵求我的意見。”

Claude Code 會讀取資料夾，編寫腳本，用簡單易懂的語言指導您完成操作，並且只有在您批准後才會執行。只需兩分鐘，您就能將過去需要花費一下午時間才能完成的瑣事自動化——而且，您可以在自己的業務中親身驗證這款工具的強大功能。.

其他重要的首要任務： 擬定一週的社群媒體文案 僅憑一篇部落格文章, 建立一個單頁定價計算器 感謝您的服務，或 清理電子表格 篩選潛在客戶並標記重複項。規則很簡單：選擇一項你已經手動完成但又討厭的工作。這就是「驚艷」之處。如果你想了解它的強大之處，同樣的循環也驅動著我的… Claude Code 插件堆疊 涵蓋一系列自動化品牌。.

一個能讓每項任務都變得更好的習慣

在讓 Claude Code 執行任何實際操作之前，花三十秒鐘告訴它上下文。創建一個簡短的文件——許多操作員都稱之為… CLAUDE.md — 在你的專案資料夾中，寫下幾句簡潔明了的話：業務內容、你希望實現的目標以及需要遵循的規則。 Claude Code 會在每次會話開始時自動讀取該文件，因此你無需每次都重複解釋，只需設定一次，它就能記住。這正是「有點用」的工具和「像一位了解你業務的隊友」之間的區別。一開始可以寫得簡潔一點——第一天只需一個段落就足夠了——然後隨著你逐漸了解自己最常需要的功能，再逐步添加。.

接下來去哪裡

你已經跨過了最艱難的一步：從「我聽說過這個」到「它正在我的電腦上運行」。以下是明智的前進方向，讓你能夠穩定前進，而不是被它壓垮。.

• 本星期： 執行三個實際任務，而不是教程。重複練習才能讓終端不再陌生。.
• 下一個： 學會保持專案整潔－每個任務一個資料夾，再附上一份簡短的說明文件，描述你的需求。 Claude Code 在有上下文的情況下才能發揮最佳效果。.
• 然後： 一旦基本操作熟練，就可以探索更深層的功能——自訂命令、防護措施以及連接自己的工具。.

目標不是成為一名程式設計師，而是擁有一個不知疲倦地坐在你的終端機前，隨時準備執行你所描述的工作的操作員。安裝只是第一步，每天使用它才是真正發揮作用的開始。.

關於安裝 Claude Code 的常見問題

我需要懂程式設計才能安裝 Claude Code 嗎？

不。安裝 Claude Code 只需幾個複製貼上的命令，使用起來也很簡單，完全可以用英語交流。你只要描述結果，代理程式就會自動編寫和編輯程式碼。非開發人員每天都在安裝和使用它。.

Claude Code 可以免費安裝嗎？

該工具本身可以免費安裝，但運行它需要 Claude 訂閱或 Anthropic API 金鑰（按使用量計費）。請參閱我們的 誠實的價格明細 對自營商來說，實際成本是多少？.

安裝 Claude Code 需要多長時間？

在Mac上大約需要十分鐘，在Windows上則需要十五分鐘左右，因為需要一次性設定WSL。大部分時間都花在下載上，而不是輸入文字。.

我可以在不使用 WSL 的情況下在 Windows 上安裝 Claude Code 嗎？

Windows 系統自備的方法雖然可行，但對於新手來說，WSL 更加流暢，也能避免大多數常見錯誤。如果你是終端新手，請使用 WSL——它是捷徑，而不是彎路。.

如果安裝失敗該怎麼辦？

將您的症狀與上述四種錯誤進行匹配——缺少 Node 版本、PATH 環境變數錯誤、權限錯誤或 Windows 系統上跳過 WSL。這四種錯誤幾乎可以解決所有安裝失敗的問題。.

結語： 終端不是一道阻擋你的大門，而是一扇讓你的業務暢通無阻的大門。現在你已經知道如何安裝 Claude Code，如何修復常見的故障，以及如何讓它在第一天就投入實際工作。今天就運行一個任務吧。這第一次自動化操作的成功，將徹底改變你對其他一切的看法。.