前言

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

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

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

操作步驟

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

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

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

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

node --version
npm --version

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

為什么需要這一步？

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

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

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

第二步：通過 npm 安裝 Claude Code

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

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

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

可以驗證是否配置成功：

npm config get registry
# 應輸出：https://registry.npmmirror.com/

為什么需要這一步？

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

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

重要提示：舊版淘寶鏡像地址 registry.npm.taobao.org 已廢棄，請務必使用新地址 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ù)的全局安裝會將 Claude Code 的可執(zhí)行文件注冊到系統(tǒng) PATH 環(huán)境變量中。這意味著無論你當前在哪個項目目錄，都可以直接在終端中輸入 claude 來啟動它，無需在每個項目中重復安裝。

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

2.3 驗證安裝

claude --version

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

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

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

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

操作步驟

訪問 CC-Switch 的 GitHub Releases 頁面，下載對應系統(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ǒng)一管理和切換 Claude Code 的供應商配置。如果你使用過 Claude Code，一定體驗過手動編輯 settings.json 配置文件來填寫 API Key 和 Base URL 的繁瑣過程。

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

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

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

配置 API Key

打開 CC-Switch 桌面應用：

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

獲取 API Key 的方式：

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

第四步：在項目文件夾中啟動 Claude Code

操作步驟

在終端中進入你要開發(fā)的項目的根目錄：

cd /path/to/your-project
claude

首次啟動時，Claude Code 會引導你完成以下初始化流程：

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

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

為什么要在項目文件夾中運行？

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

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

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

常用啟動命令速查

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

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

原生安裝方式（適用于各平臺）：

# 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

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

常見問題排查

Q1：安裝時報權(quán)限錯誤（Windows）

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

Q2：claude命令找不到

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

npm root -g

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

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

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

npm cache clean --force

總結(jié)

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

最新評論