Claude Code 完整安裝攻略:手把手小白到精通

發(fā)布時間：2026-07-24 11:46:34 作者：AI老猿博士

Claude Code 是 Anthropic 推出的 AI 編程助手，可以通過命令行使用，本文詳細(xì)介紹了從系統(tǒng)要求、賬號注冊、API Key 配置，到多種安裝方式（推薦腳本安裝）、環(huán)境變量設(shè)置、首次啟動驗證，再到 IDE 集成和進(jìn)階模型配置的全過程，感興趣的朋友跟隨小編一起看看吧

摘要：本文是一份面向初學(xué)者的 Claude Code 安裝與配置指南。Claude Code 是 Anthropic 推出的 AI 編程助手，可以通過命令行使用。本文詳細(xì)介紹了從系統(tǒng)要求、賬號注冊、API Key 配置，到多種安裝方式（推薦腳本安裝）、環(huán)境變量設(shè)置、首次啟動驗證，再到 IDE 集成和進(jìn)階模型配置的全過程。核心目標(biāo)是幫助讀者快速、正確地完成 Claude Code 的安裝與基礎(chǔ)配置，并開始使用。

適用版本：v2.1.133（驗證于 2026-06-10） | 安裝方式：原生安裝 + npm 標(biāo)準(zhǔn)安裝并存

?? 學(xué)習(xí)目標(biāo)

通過本指南，你將能夠：

理解 Claude Code 的核心概念：掌握 CLI、API Key、環(huán)境變量等關(guān)鍵術(shù)語
完成 Claude Code 的完整安裝：根據(jù)你的操作系統(tǒng)選擇最適合的安裝方式
正確配置 API Key 和環(huán)境變量：確保 Claude Code 能夠正常連接 Anthropic 服務(wù)
驗證安裝并成功啟動：運行 Hello World 項目確認(rèn)一切正常
集成到常用 IDE 中：在 VS Code、Cursor、JetBrains 等開發(fā)環(huán)境中使用 Claude Code
排查常見問題：遇到安裝、配置、啟動等問題時能夠快速定位并解決

??? 學(xué)習(xí)導(dǎo)航（思維導(dǎo)圖）

以下是本指南的學(xué)習(xí)路徑，建議按順序閱讀：

階段	主要內(nèi)容	預(yù)計耗時	關(guān)鍵產(chǎn)出
?? 準(zhǔn)備階段	了解系統(tǒng)要求注冊 Anthropic 賬號獲取 API Key	10-15分鐘	可用的 API Key
?? 安裝階段	選擇安裝方式（推薦腳本安裝）完成 Claude Code 安裝配置 PATH 環(huán)境變量（Windows 用戶必讀）	5-10分鐘	安裝成功的 Claude Code
?? 配置階段	設(shè)置環(huán)境變量首次啟動與初始化 Hello World 驗證	5-10分鐘	可正常運行的 Claude Code
?? 進(jìn)階階段	IDE 集成配置模型配置與選擇權(quán)限管理與安全注意事項	10-20分鐘	深度集成的開發(fā)環(huán)境
??? 排錯階段	常見問題排查錯誤分析與解決性能優(yōu)化建議	按需	問題解決能力

快速定位：

如果你是完全新手：請從「一、系統(tǒng)要求」開始，按順序閱讀
如果你已有 API Key：可直接跳到「四、Claude Code 安裝步驟」
如果你安裝后遇到問題：請查看「九、常見問題與排查」
如果你想集成到 IDE：請查看「七、IDE 集成配置」

術(shù)語表

術(shù)語	通俗解釋
CLI	命令行界面，黑色/白色的文字輸入窗口
原生安裝器	Claude Code官方獨立安裝程序，無需其他依賴
Node.js	JavaScript運行環(huán)境；npm安裝路徑需 18+
npm	Node.js包管理器；標(biāo)準(zhǔn)安裝路徑之一
API Key	API密鑰，類似“通行證”，證明使用權(quán)
Token	計費單位，約0.75個英文單詞或1-2個漢字
環(huán)境變量	操作系統(tǒng)級配置項，程序讀取但不寫在代碼里
PATH	系統(tǒng)環(huán)境變量，告訴電腦去哪里找可執(zhí)行程序

一、系統(tǒng)要求

快速檢查（核心3項）

檢查項	最低要求	檢查方法
操作系統(tǒng)	Windows 10 / macOS 10.15+ / Linux	查看系統(tǒng)版本
內(nèi)存	4GB RAM	右鍵“此電腦”→屬性
網(wǎng)絡(luò)	能訪問網(wǎng)	`ping api.anthropic.com`

詳細(xì)兼容性

操作系統(tǒng)	最低版本	推薦版本
Windows	Windows 10	Windows 11（64位）
macOS	10.15 Catalina	macOS 13+（Intel/Apple Silicon均支持）
Linux	內(nèi)核3.10+	5.x+（Ubuntu/Debian/Fedora等）

二、Anthropic 賬號與 API Key 配置

注冊流程

訪問 https://console.anthropic.com/https://console.anthropic.com/https://console.anthropic.com/https://console.anthropic.com/
https://console.anthropic.com/
點擊“Sign Up”（支持Google/GitHub/郵箱注冊）
手機(jī)驗證（不支持 +86 中國大陸號碼）

API Key 獲取

進(jìn)入 App unavailable in region | Claude by Anthropic
點擊“Create Key”，填寫名稱，選擇“Full Access”
立即復(fù)制并保存
格式示例：sk-xxxxxxxxxxxxxxxx...

環(huán)境變量配置

Windows（PowerShell 7，推薦）：

# 永久添加用戶環(huán)境變量
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-api03-你的key', 'User')
驗證
$env:ANTHROPIC_API_KEY
臨時（僅當(dāng)前終端）
$env:ANTHROPIC_API_KEY="sk-ant-api03-你的key"

macOS/Linux：

# 編輯配置文件（zsh用戶編輯 ~/.zshrc，bash用戶編輯 ~/.bashrc）
export ANTHROPIC_API_KEY="sk-ant-api03-你的key"
重新加載
source ~/.zshrc  # 或 source ~/.bashrc
驗證
echo $ANTHROPIC_API_KEY

API中轉(zhuǎn)站配置（可選up8ai.com）

# 同時配置 Key 和 Base URL
export ANTHROPIC_API_KEY="你的中轉(zhuǎn)站Key"
export ANTHROPIC_BASE_URL="https://你的中轉(zhuǎn)站地址"

三、安裝方式對比

對比項	原生安裝 ?	npm標(biāo)準(zhǔn)安裝
需要Node.js	? 不需要	? 需要 18+
安裝時間	?? 3-5分鐘	?? 30-40分鐘
自動更新	? 內(nèi)置	?? 需手動更新
PATH配置	? 自動	?? 經(jīng)常出錯
穩(wěn)定性	? 生產(chǎn)級	?? 依賴環(huán)境

四、Claude Code 安裝步驟

方式1：腳本安裝（推薦）

macOS / Linux / WSL：

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

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

方式2：Homebrew安裝（macOS/Linux）

brew install --cask claude-code
# 更新：brew upgrade claude-code
# 卸載：brew uninstall claude-code

方式3：WinGet安裝（Windows 10/11）

winget install Anthropic.ClaudeCode
# 更新：winget upgrade Anthropic.ClaudeCode

方式4：npm安裝（標(biāo)準(zhǔn)兼容路徑）

# 前提：Node.js 18+
node --version
全局安裝
npm install -g @anthropic-ai/claude-code
驗證
claude --version  # 顯示 (npm)

五、PATH 環(huán)境變量配置（Windows 必讀）

安裝位置

原生安裝：C:\Users\<用戶名>\.local\bin\
npm安裝：C:\Users\<用戶名>\AppData\Roaming\npm\

配置方法

PowerShell命令（推薦）：

[System.Environment]::SetEnvironmentVariable(
    'Path',
    [System.Environment]::GetEnvironmentVariable('Path', 'User') + ';' + "$env:USERPROFILE\.local\bin",
    'User'
)
# 必須重啟終端生效！

圖形界面：

Win+R → sysdm.cpl → 高級 → 環(huán)境變量
用戶變量 → Path → 新建 → 添加 %USERPROFILE%\.local\bin
確定保存，重啟終端

macOS/Linux（如未自動配置）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

驗證安裝

claude --version     # 預(yù)期：Claude Code v2.1.x (native)
claude --help        # 顯示幫助信息
which claude         # 或 where claude (Windows)

六、首次啟動與驗證

啟動方式

1. 標(biāo)準(zhǔn)交互模式：

claude

2. 單次命令模式：

claude "你的問題或指令"

3. 打印模式（腳本友好）：

claude -p "你的問題"

首次啟動初始化流程

選擇主題：Light / Dark / System
安全須知確認(rèn)：理解權(quán)限模型（沙盒隔離、確認(rèn)機(jī)制、只讀優(yōu)先、審計日志）
目錄信任確認(rèn)：選擇是否信任當(dāng)前目錄
認(rèn)證方式選擇：
- API Key（環(huán)境變量，推薦）
- Claude App Login（Pro/Max訂閱）
- 手動輸入
- 第三方平臺（v2.1.92+支持Bedrock交互式向?qū)В?/li>

配置文件結(jié)構(gòu)

~/.claude/                  ← 全局配置
├── config.json
├── auth-token.json
├── trusted-directories.json
├── cache/
└── logs/
項目目錄/.claude/           ← 項目級配置
├── config.json
├── commands/
├── skills/
└── hooks/

--dangerously-skip-permissions參數(shù)（重要安全警告）

作用：跳過所有權(quán)限詢問，AI直接執(zhí)行操作（讀/寫/運行命令）。

風(fēng)險數(shù)據(jù)（eesel AI研究）：32%誤修改率。

使用建議：

? 個人學(xué)習(xí)項目、只讀查詢
? 公司項目、生產(chǎn)環(huán)境、首次使用、敏感數(shù)據(jù)

用法：

claude --dangerously-skip-permissions -p "分析這個項目的依賴關(guān)系"

Hello World 驗證

mkdir ~/claude-hello-world && cd ~/claude-hello-world
git init
claude -p "請創(chuàng)建一個Python Hello World項目，包含：
hello.py - 打印 'Hello, Claude Code!'
README.md - 項目說明
.gitignore - Python標(biāo)準(zhǔn)忽略文件"
python hello.py  # 預(yù)期輸出：Hello, Claude Code!

驗證清單

claude --version                     # v2.1.x+ (native)
claude --help                        # 顯示命令列表
echo $ANTHROPIC_API_KEY              # 顯示完整Key
ping api.anthropic.com               # 有響應(yīng)

七、常見問題與排查

在安裝、配置和啟動 Claude Code 的過程中，可能會遇到一些常見問題。下表列出了這些問題及其解決方案，幫助你快速排查。

安裝問題

問題現(xiàn)象	可能原因	排查步驟	解決方案
`command not found: claude`	PATH 環(huán)境變量未正確配置	運行 `which claude`（macOS/Linux）或 `where claude`（Windows）檢查輸出路徑是否在 PATH 中檢查安裝目錄是否存在	Windows：按「五、PATH 環(huán)境變量配置」重新配置 PATH macOS/Linux：運行 `echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc` npm 安裝：檢查 Node.js 版本（需 18+）
腳本安裝失?。╟url/irm 錯誤）	網(wǎng)絡(luò)連接問題或腳本下載失敗	檢查網(wǎng)絡(luò)連接：`ping api.anthropic.com` 嘗試手動下載腳本并運行檢查防火墻/代理設(shè)置	使用代理或更換網(wǎng)絡(luò)環(huán)境手動下載安裝腳本： macOS/Linux：`curl -O https://claude.ai/install.sh && bash install.sh` Windows：瀏覽器下載 install.ps1，右鍵「使用 PowerShell 運行」嘗試其他安裝方式（Homebrew/WinGet）
Homebrew/WinGet 安裝失敗	包管理器未安裝或版本過舊	檢查包管理器：`brew --version` 或 `winget --version` 更新包管理器：`brew update` 或 `winget upgrade --all`	安裝/更新包管理器使用腳本安裝（推薦）檢查系統(tǒng)是否滿足最低要求

配置問題

問題現(xiàn)象	可能原因	排查步驟	解決方案
`Invalid API Key` 或認(rèn)證失敗	API Key 未設(shè)置、格式錯誤或已失效	檢查環(huán)境變量：`echo $ANTHROPIC_API_KEY`（macOS/Linux）或 `$env:ANTHROPIC_API_KEY`（Windows）確認(rèn) Key 以 `sk-ant-api03-` 開頭在 Anthropic 控制臺檢查 Key 狀態(tài)	重新設(shè)置環(huán)境變量（參考「二、環(huán)境變量配置」）重啟終端或電腦使環(huán)境變量生效在 Anthropic 控制臺生成新 Key 并替換檢查是否有空格或特殊字符
網(wǎng)絡(luò)連接超時	無法訪問 Anthropic API 服務(wù)器	運行 `ping api.anthropic.com` 檢查代理設(shè)置嘗試訪問 `https://console.anthropic.com`	配置代理：設(shè)置 `HTTP_PROXY`/`HTTPS_PROXY` 環(huán)境變量使用 API 中轉(zhuǎn)站（參考「API中轉(zhuǎn)站配置」）檢查防火墻設(shè)置嘗試更換網(wǎng)絡(luò)環(huán)境
權(quán)限不足錯誤	安裝目錄權(quán)限問題	檢查安裝目錄權(quán)限：`ls -la ~/.local/bin/`（macOS/Linux）嘗試以管理員/root 權(quán)限運行安裝命令	macOS/Linux：`sudo bash install.sh` Windows：以管理員身份運行 PowerShell 手動修改目錄權(quán)限

啟動與運行問題

問題現(xiàn)象	可能原因	排查步驟	解決方案
啟動后無響應(yīng)或卡住	網(wǎng)絡(luò)問題或 API 限流	檢查網(wǎng)絡(luò)連接查看日志：`~/.claude/logs/` 嘗試 `claude --version` 測試基礎(chǔ)功能	等待幾分鐘后重試檢查 API 使用量是否超限使用 `claude -p "簡單測試"` 測試單次命令模式重啟 Claude Code
命令執(zhí)行失敗	權(quán)限設(shè)置或沙盒限制	檢查當(dāng)前目錄是否在信任列表中查看權(quán)限確認(rèn)日志嘗試在非敏感目錄測試	在啟動時信任當(dāng)前目錄使用 `--dangerously-skip-permissions`（僅限個人項目）檢查配置文件中的權(quán)限設(shè)置
版本不匹配錯誤	多版本沖突或緩存問題	運行 `claude --version` 查看當(dāng)前版本檢查是否有多個安裝：`which -a claude` 清除緩存：`rm -rf ~/.claude/cache/`	卸載沖突版本：`npm uninstall -g @anthropic-ai/claude-code` 重新安裝最新版本更新 PATH 環(huán)境變量指向正確版本

其他問題

問題現(xiàn)象	可能原因	排查步驟	解決方案
IDE 集成不工作	IDE 配置錯誤或 PATH 問題	在終端中測試 `claude` 命令是否可用檢查 IDE 的終端配置確認(rèn) IDE 使用的終端類型	重啟 IDE 使環(huán)境變量生效在 IDE 設(shè)置中配置正確的終端路徑參考「七、IDE 集成配置」重新配置
模型切換無效	模型別名錯誤或權(quán)限不足	檢查當(dāng)前模型：`claude --model` 查看可用模型：參考「八、模型配置」檢查 API Key 權(quán)限	使用正確的模型別名：`claude --model sonnet` 升級 API 套餐以獲得更多模型訪問權(quán)限檢查配置文件中的模型設(shè)置
輸出亂碼或格式錯誤	終端編碼問題或字體不支持	檢查終端編碼設(shè)置嘗試不同的終端應(yīng)用檢查系統(tǒng)語言和區(qū)域設(shè)置	設(shè)置終端編碼為 UTF-8 安裝支持 Unicode 的字體（如 Cascadia Code）使用 `claude -p` 打印模式獲取純文本輸出

如果以上方法都無法解決問題：

查看詳細(xì)日志
在 Anthropic 官方文檔或社區(qū)論壇搜索錯誤信息
嘗試完全卸載后重新安裝
聯(lián)系 Anthropic 技術(shù)支持

八、IDE 集成配置

VS Code 配置

settings.json：

{
  "terminal.integrated.defaultProfile.windows": "PowerShell",
  "terminal.integrated.defaultProfile.osx": "zsh",
  "terminal.integrated.defaultProfile.linux": "bash",
  "terminal.integrated.profiles.windows": {
    "PowerShell": {
      "source": "PowerShell",
      "icon": "terminal-powershell",
      "path": "pwsh.exe"
    }
  },
  "files.associations": {
    "CLAUDE.md": "markdown"
  },
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000
}

tasks.json（.vscode/tasks.json）：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Claude Code: 啟動交互模式",
      "type": "shell",
      "command": "claude",
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": true,
        "panel": "dedicated",
        "clear": true
      }
    },
    {
      "label": "Claude Code: 審查當(dāng)前文件",
      "type": "shell",
      "command": "claude \"Review ${relativeFile} and suggest improvements\""
    },
    {
      "label": "Claude Code: 解釋當(dāng)前文件",
      "type": "shell",
      "command": "claude \"Explain what ${relativeFile} does\""
    },
    {
      "label": "Claude Code: 生成測試",
      "type": "shell",
      "command": "claude \"Generate unit tests for ${relativeFile}\""
    }
  ]
}

keybindings.json：

[
  { "key": "ctrl+shift+c", "command": "workbench.action.tasks.runTask", "args": "Claude Code: 啟動交互模式" },
  { "key": "ctrl+shift+r", "command": "workbench.action.tasks.runTask", "args": "Claude Code: 審查當(dāng)前文件" },
  { "key": "ctrl+shift+e", "command": "workbench.action.tasks.runTask", "args": "Claude Code: 解釋當(dāng)前文件" }
]

Cursor 配置

配置與VS Code完全相同
settings.json位置：
- Windows: C:\Users\<用戶名>\AppData\Roaming\Cursor\User\settings.json
- Mac: ~/Library/Application Support/Cursor/User/settings.json

JetBrains IDEs（WebStorm/PyCharm/IntelliJ）

Settings → Tools → External Tools → 點擊 +
添加工具：
- Name: Claude Code
- Program: claude
- Working directory: $ProjectFileDir$
Settings → Keymap → 搜索 External Tools → 設(shè)置快捷鍵

九、模型配置（進(jìn)階）

可用模型別名

別名	含義	適用場景
`default`	系統(tǒng)默認(rèn)模型	不想手動管版本
`best`	當(dāng)前最強（等價于opus）	追求最強效果
`sonnet`	最新Sonnet	日常編碼主力
`opus`	最新Opus	復(fù)雜推理、架構(gòu)
`haiku`	更快更輕量	簡單任務(wù)
`sonnet[1m]`	Sonnet + 1M上

到此這篇關(guān)于Claude Code 完整安裝指南:手把手小白到精通的文章就介紹到這了,更多相關(guān)Claude Code安裝指南內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

Tag：安裝 code Claude

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线