前言

Claude Code 是由 Anthropic 推出的終端級(jí) AI 編程助手，能夠讓開發(fā)者通過自然語言進(jìn)行代碼生成、代碼審查、Git 提交管理等操作。本文將詳細(xì)介紹從環(huán)境準(zhǔn)備到完整運(yùn)行 Claude Code 的全部步驟，并對(duì)每個(gè)操作解釋其背后的原因，幫助新手不僅知道“怎么裝”，更理解“為什么這樣裝”。

環(huán)境要求：Node.js 18.0 及以上版本，支持 Windows 10/11、macOS 10.15+ 及主流 Linux 發(fā)行版。

第一步：下載并安裝 Node.js

操作步驟

訪問 Node.js 中文鏡像站下載安裝包：

下載地址：https://nodejs.cn/download/

選擇 LTS（長期支持）版本，下載對(duì)應(yīng)系統(tǒng)的安裝包（Windows 選 .msi，macOS 選 .pkg），雙擊運(yùn)行，一路點(diǎn)擊 “Next” 完成安裝。

安裝完成后，打開終端（CMD / PowerShell / Git Bash），驗(yàn)證安裝是否成功：

node --version
npm --version

如果兩條命令都能正常輸出類似 v20.xx.x 和 10.xx.x 的版本號(hào)，說明安裝成功。

為什么需要這一步？

Claude Code 是一個(gè)基于 Node.js 構(gòu)建的 CLI 工具，它依賴 Node.js 的 JavaScript 運(yùn)行時(shí)環(huán)境和 npm（Node Package Manager）包管理器來下載、安裝和運(yùn)行。簡單來說，沒有 Node.js，npm 就無法工作，而 Claude Code 必須通過 npm 來安裝。

選擇 LTS 版本 而非最新版的原因是：LTS 版本經(jīng)過了長期的穩(wěn)定性驗(yàn)證，在生產(chǎn)環(huán)境和企業(yè)開發(fā)中兼容性最好，能有效避免因 Node.js 自身 Bug 導(dǎo)致的安裝失敗或運(yùn)行異常。

使用 nodejs.cn 而非 nodejs.org 下載，是因?yàn)楣俜骄W(wǎng)站在國內(nèi)訪問速度較慢甚至可能無法打開，中文鏡像站提供了完全一致的安裝包，下載速度更快。

第二步：通過 npm 安裝 Claude Code

2.1 設(shè)置 npm 淘寶鏡像源（永久生效）

在終端中執(zhí)行以下命令：

npm config set registry https://registry.npmmirror.com

可以驗(yàn)證是否配置成功：

npm config get registry
# 應(yīng)輸出：https://registry.npmmirror.com/

為什么需要這一步？

npm 的默認(rèn)官方源 https://registry.npmjs.org 服務(wù)器位于海外，國內(nèi)用戶訪問時(shí)經(jīng)常遇到下載速度極慢甚至超時(shí)中斷的問題。registry.npmmirror.com 是淘寶團(tuán)隊(duì)維護(hù)的國內(nèi)高速鏡像，同步頻率高、覆蓋完整，能大幅提升包的下載速度。

npm config set 命令會(huì)將鏡像源地址寫入用戶級(jí)的 npm 配置文件（~/.npmrc），因此只需要執(zhí)行一次，之后所有 npm 安裝都會(huì)自動(dòng)走國內(nèi)鏡像，無需每次手動(dòng)指定。

重要提示：舊版淘寶鏡像地址 registry.npm.taobao.org 已廢棄，請(qǐng)務(wù)必使用新地址 registry.npmmirror.com。

2.2 全局安裝 Claude Code

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

參數(shù)說明：

• install（可簡寫為 i）：安裝指定的包
• -g（global）：全局安裝，安裝后的命令可在系統(tǒng)任意目錄下使用
• @anthropic-ai/claude-code：Claude Code 的 npm 包名

為什么是全局安裝？

帶 -g 參數(shù)的全局安裝會(huì)將 Claude Code 的可執(zhí)行文件注冊到系統(tǒng) PATH 環(huán)境變量中。這意味著無論你當(dāng)前在哪個(gè)項(xiàng)目目錄，都可以直接在終端中輸入 claude 來啟動(dòng)它，無需在每個(gè)項(xiàng)目中重復(fù)安裝。

如果省略 -g（本地安裝），Claude Code 只會(huì)被安裝到當(dāng)前項(xiàng)目的 node_modules 目錄中，無法在全局范圍調(diào)用。

2.3 驗(yàn)證安裝

claude --version

如果輸出版本號(hào)（如 v1.0.xx），說明安裝成功。

如果提示 'claude' 不是內(nèi)部或外部命令，常見原因及解決方案：

• Windows 用戶：確保以管理員身份運(yùn)行終端，或檢查 Node.js 是否正確加入 PATH
• 權(quán)限問題：可以嘗試重新執(zhí)行安裝命令，或檢查 npm 全局安裝路徑的權(quán)限設(shè)置

第三步：安裝 CC-Switch 配置管理工具（可選但推薦）

操作步驟

訪問 CC-Switch 的 GitHub Releases 頁面，下載對(duì)應(yīng)系統(tǒng)的安裝包：

下載地址：https://github.com/farion1231/cc-switch/releases/download/v3.14.1/CC-Switch-v3.14.1-Windows.msi

（macOS 用戶可下載 .dmg 文件，Linux 用戶可下載 .deb 或 .AppImage 文件）

下載完成后雙擊安裝包，按提示完成安裝。

什么是 CC-Switch？為什么推薦安裝？

CC-Switch 是一款跨平臺(tái)桌面應(yīng)用，用于統(tǒng)一管理和切換 Claude Code 的供應(yīng)商配置。如果你使用過 Claude Code，一定體驗(yàn)過手動(dòng)編輯 settings.json 配置文件來填寫 API Key 和 Base URL 的繁瑣過程。

CC-Switch 內(nèi)置了 50+ 供應(yīng)商預(yù)設(shè)（包括 Anthropic 官方、SiliconFlow、OpenAI 等），選擇預(yù)設(shè)后只需填寫 API Key，一鍵即可生效。它的核心功能包括：

• 供應(yīng)商一鍵切換：主界面或系統(tǒng)托盤秒級(jí)切換不同 API 供應(yīng)商
• MCP 統(tǒng)一管理：跨應(yīng)用管理 MCP 服務(wù)器配置
• 用量統(tǒng)計(jì)：Token 消耗追蹤與成本監(jiān)控
• 提示詞管理：Markdown 編輯器，同步到 CLAUDE.md 文件

對(duì)于需要同時(shí)使用多個(gè) API 供應(yīng)商（如開發(fā)環(huán)境用官方、生產(chǎn)環(huán)境用第三方中轉(zhuǎn)）的開發(fā)者來說，CC-Switch 可以大幅簡化配置管理工作。

配置 API Key

打開 CC-Switch 桌面應(yīng)用：

1. 在頂部應(yīng)用切換器中，確認(rèn)當(dāng)前選中的是 Claude
2. 點(diǎn)擊右上角的 + 按鈕，打開添加供應(yīng)商面板
3. 在「預(yù)設(shè)」下拉框中選擇對(duì)應(yīng)的供應(yīng)商（如 Anthropic、SiliconFlow 等）
4. 填寫你的 API Key
5. 保存配置，切換到新配置即可生效

獲取 API Key 的方式：

• 官方渠道：登錄 Anthropic Console（https://console.anthropic.com），在 API Keys 頁面創(chuàng)建密鑰
• 第三方供應(yīng)商（如 SiliconFlow）：登錄對(duì)應(yīng)平臺(tái)的控制臺(tái)，在 API 密鑰管理頁面獲取

第四步：在項(xiàng)目文件夾中啟動(dòng) Claude Code

操作步驟

在終端中進(jìn)入你要開發(fā)的項(xiàng)目的根目錄：

cd /path/to/your-project
claude

首次啟動(dòng)時(shí)，Claude Code 會(huì)引導(dǎo)你完成以下初始化流程：

1. 選擇喜歡的主題（dark / light）
2. 確認(rèn)安全須知
3. 選擇默認(rèn)的終端配置
4. 信任當(dāng)前工作目錄
5. 驗(yàn)證 API 連接是否正常

啟動(dòng)成功后，你就可以在終端中通過自然語言與 Claude Code 交互了。

為什么要在項(xiàng)目文件夾中運(yùn)行？

Claude Code 是上下文感知的 AI 編程助手。當(dāng)你從項(xiàng)目根目錄啟動(dòng)它時(shí)，它會(huì)自動(dòng)將整個(gè)項(xiàng)目的文件結(jié)構(gòu)和代碼作為上下文，從而能夠：

• 理解項(xiàng)目架構(gòu)和依賴關(guān)系
• 直接讀取、修改項(xiàng)目中的文件
• 執(zhí)行 git 命令管理版本
• 在項(xiàng)目目錄下創(chuàng)建 .claude/CLAUDE.md 記憶文件，記錄項(xiàng)目信息

如果不在項(xiàng)目目錄中啟動(dòng)，Claude Code 沒有可操作的代碼上下文，大部分核心功能無法正常使用。

常用啟動(dòng)命令速查

補(bǔ)充說明：npm 安裝與原生安裝的區(qū)別

本文介紹的 npm 安裝方式是目前最通用、文檔最豐富的安裝方法，適合所有平臺(tái)。不過需要說明的是，Anthropic 在 2026 年已推出原生安裝方式，無需 Node.js 依賴，安裝更簡潔，且支持自動(dòng)更新。

原生安裝方式（適用于各平臺(tái)）：

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

# Windows（PowerShell）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果你追求最新體驗(yàn)，可以嘗試原生方式；如果希望最大程度兼容現(xiàn)有文檔和教程，npm 方式依然是可靠的選擇。兩種方式安裝的 Claude Code 功能完全一致。

常見問題排查

Q1：安裝時(shí)報(bào)權(quán)限錯(cuò)誤（Windows）

以管理員身份運(yùn)行命令提示符或 PowerShell，然后重新執(zhí)行安裝命令。

Q2：claude命令找不到

檢查 npm 全局安裝路徑是否在系統(tǒng) PATH 中：

npm root -g

Windows 下默認(rèn)路徑通常為 C:\Users\你的用戶名\AppData\Roaming\npm，確保該路徑已添加到系統(tǒng)環(huán)境變量中。

Q3：切換鏡像后安裝依然很慢

可以嘗試清除 npm 緩存后重試：

npm cache clean --force

總結(jié)

以上就是Claude Code完整安裝與配置指南(含CC-Switch多供應(yīng)商切換工具)的詳細(xì)內(nèi)容，更多關(guān)于Claude Code完整安裝與配置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論