摘要：本文檔詳細(xì)記錄了在 Windows 環(huán)境下，將 Claude Code 從 C 盤完整遷移到 D 盤（D:\app\Claude-code）的全流程操作。內(nèi)容涵蓋系統(tǒng)環(huán)境前置要求、舊版卸載備份、新版安裝、配置文件與環(huán)境變量設(shè)置、驗(yàn)證步驟以及踩坑經(jīng)驗(yàn)。所有命令均在 Windows PowerShell 5.1 中驗(yàn)證通過，旨在解決 C 盤空間占用問題并實(shí)現(xiàn)多盤符規(guī)范管理。

一、 系統(tǒng)環(huán)境前置要求

1.1 當(dāng)前系統(tǒng)環(huán)境信息

重要說明：本文檔中的命令均在 Windows PowerShell 5.1 (C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe) 中執(zhí)行。PowerShell 5.1 不支持 && 作為語句分隔符，需使用 ; 分號(hào)代替。

1.2 Node.js 安裝（如未安裝）

Claude Code 運(yùn)行依賴 Node.js，需要 v18+ 版本。

從 https://nodejs.org/ 下載 LTS 版本（推薦 v20+）。

安裝時(shí)務(wù)必勾選 "Add to PATH"。

驗(yàn)證安裝：

node -v   # 應(yīng)輸出 v20.x.x 或更高
npm -v    # 應(yīng)輸出 10.x.x 或更高

1.3 Git 安裝（如未安裝）

Claude Code 的 plugins 和 marketplaces 依賴 Git 克隆倉庫。

從 https://git-scm.com/download/win 下載。

安裝時(shí)保持默認(rèn)選項(xiàng)即可。

驗(yàn)證安裝：

git --version  # 應(yīng)輸出 git version 2.x.x

1.4 PowerShell Core 安裝（可選）

如果需要 PowerShell 7.x（pwsh），可通過以下方式安裝：

winget install Microsoft.PowerShell

驗(yàn)證：pwsh -v（輸出 PowerShell 7.5.4 等）

1.5 關(guān)于 npm 版本

npm 11.x 自帶于 Node.js v24。若使用較低 Node.js 版本，可通過 npm install -g npm@latest 升級(jí)。Claude Code 的 npm install --prefix 方式安裝不依賴全局 npm 特殊功能，常規(guī)版本即可。

二、 卸載舊版 Claude Code

2.1 查看當(dāng)前安裝情況

在卸載之前，先確認(rèn)舊版安裝的位置和版本：

# 查看 claude 命令所在路徑
where claude

# 查看全局安裝的包版本
npm list -g @anthropic-ai/claude-code

# 查看 C 盤上的 Claude Code 相關(guān)文件
Get-ChildItem -Path "C:\Users\Administrator" -Filter ".claude*" -Force
Get-ChildItem -Path "C:\Users\Administrator\.claude" -Force

舊版安裝情況示例：

• 可執(zhí)行文件：C:\Users\Administrator\AppData\Roaming\npm\claude.cmd
• npm 包位置：C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code
• 數(shù)據(jù)目錄：C:\Users\Administrator\.claude\（包含 sessions、cache、plugins、skills、telemetry 等）
• 用戶狀態(tài)：C:\Users\Administrator\.claude.json
• 臨時(shí)文件：C:\Users\Administrator\AppData\Local\Temp\claude

2.2 使用 npm 卸載舊版全局包

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

此命令會(huì)移除：

• C:\Users\Administrator\AppData\Roaming\npm\claude
• C:\Users\Administrator\AppData\Roaming\npm\claude.cmd
• C:\Users\Administrator\AppData\Roaming\npm\claude.ps1
• C:\Users\Administrator\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\

2.3 備份重要配置文件

清理前務(wù)必先備份！ 將關(guān)鍵配置備份到 D 盤目標(biāo)目錄：

# 先創(chuàng)建目標(biāo)目錄
New-Item -Path "D:\app\Claude-code\data" -ItemType Directory -Force

# 備份 settings.json（含 API 配置、插件設(shè)置等）
Copy-Item "C:\Users\Administrator\.claude\settings.json" "D:\app\Claude-code\settings.json.bak" -Force

# 備份 statusline-command.sh（狀態(tài)欄配置腳本）
Copy-Item "C:\Users\Administrator\.claude\statusline-command.sh" "D:\app\Claude-code\statusline-command.sh.bak" -Force

2.4 清理 C 盤舊數(shù)據(jù)目錄

備份完成后，刪除占用空間的舊數(shù)據(jù)目錄：

# 刪除舊的數(shù)據(jù)目錄（sessions、cache、plugins、skills、telemetry等大量文件）
Remove-Item -Path "C:\Users\Administrator\.claude" -Recurse -Force

# 清理臨時(shí)文件
Remove-Item -Path "C:\Users\Administrator\AppData\Local\Temp\claude" -Recurse -Force -ErrorAction SilentlyContinue

2.5 保留 .claude.json（不要?jiǎng)h除）

重要提示：不要?jiǎng)h除 C:\Users\Administrator\.claude.json！

• 這是用戶狀態(tài)文件（含 hasCompletedOnboarding: true、項(xiàng)目歷史、啟動(dòng)計(jì)數(shù)等）。
• 位置固定在用戶目錄下，不受 CLAUDE_CONFIG_DIR 環(huán)境變量控制。
• 刪除后會(huì)重新觸發(fā)首次引導(dǎo)（onboarding）流程。
• 文件很小（約 10~50KB），不占空間。

三、 安裝最新版 Claude Code 到 D 盤

3.1 創(chuàng)建目標(biāo)目錄結(jié)構(gòu)

如果在第 2.3 步備份時(shí)已創(chuàng)建，可跳過此步：

New-Item -Path "D:\app\Claude-code\data" -ItemType Directory -Force

3.2 使用 npm --prefix 本地安裝

此方式不會(huì)在 C 盤的全局 npm 目錄中生成文件，所有內(nèi)容都在 D 盤指定目錄下：

npm install --prefix "D:\app\Claude-code" @anthropic-ai/claude-code@latest

安裝完成后目錄結(jié)構(gòu)：

D:\app\Claude-code\
├── data\                        ← 配置和數(shù)據(jù)目錄（由 CLAUDE_CONFIG_DIR 指向）
│   └── settings.json            ← 兜底配置文件（默認(rèn)路徑不存在時(shí)讀取此文件）
├── node_modules\
│   ├── .bin\
│   │   ├── claude.cmd           ← Windows 可執(zhí)行文件
│   │   └── claude               ← Unix 可執(zhí)行文件
│   └── @anthropic-ai\
│       └── claude-code\         ← 程序本體
├── package.json
├── package-lock.json
├── settings.json.bak            ← 舊配置備份
└── statusline-command.sh.bak    ← 舊狀態(tài)欄腳本備份

3.3 驗(yàn)證安裝

& "D:\app\Claude-code\node_modules\.bin\claude.cmd" --version
# 輸出示例: 2.1.150 (Claude Code)

四、 配置環(huán)境變量

本節(jié)設(shè)置的環(huán)境變量均為 用戶級(jí) 環(huán)境變量（寫入注冊(cè)表），僅當(dāng)前用戶生效。

4.1 設(shè)置 CLAUDE_CONFIG_DIR（必須）

讓 Claude Code 的數(shù)據(jù)文件（sessions、cache、history、plugins等大體積文件）存儲(chǔ)到 D 盤：

[System.Environment]::SetEnvironmentVariable("CLAUDE_CONFIG_DIR", "D:\app\Claude-code\data", "User")

4.2 添加 PATH（必須）

讓 claude 命令在任何目錄下都可直接使用：

$currentPath = [System.Environment]::GetEnvironmentVariable("Path", "User")
$newBin = "D:\app\Claude-code\node_modules\.bin"
if ($currentPath -notlike "*$newBin*") {
    [System.Environment]::SetEnvironmentVariable("Path", "$newBin;$currentPath", "User")
}

4.3 不要設(shè)置 ANTHROPIC_* 為系統(tǒng)環(huán)境變量

嚴(yán)重警告：ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_DEFAULT_SONNET_MODEL 等 API 相關(guān)變量絕對(duì)不能設(shè)為系統(tǒng)環(huán)境變量！

• 系統(tǒng)環(huán)境變量優(yōu)先級(jí) 高于 settings.json 中的 env 字段。
• 設(shè)置后會(huì)導(dǎo)致 ccswitch 切換模型不生效（因?yàn)楸画h(huán)境變量覆蓋）。
• 手動(dòng)修改 settings.json 也不生效（同理）。
• API 配置只應(yīng)通過 settings.json 的 env 字段管理。

4.4 環(huán)境變量匯總

最終應(yīng)設(shè)置的用戶環(huán)境變量（僅此兩項(xiàng)）：

五、 配置 settings.json

5.1 配置文件作用說明

settings.json 是 Claude Code 的核心配置文件，包含：

• env 字段：API 密鑰、模型名稱、Base URL 等（Claude Code 啟動(dòng)時(shí)自動(dòng)注入為進(jìn)程環(huán)境變量）。
• enabledPlugins：啟用的插件列表。
• extraKnownMarketplaces：第三方插件市場源。
• language：界面語言。

5.2 MiniMax API 配置（跳過官方登錄）

在 D:\app\Claude-code\data\settings.json 中寫入：

{
  "enabledPlugins": {
    "gopls-lsp@claude-plugins-official": true,
    "superpowers@claude-plugins-official": true
  },
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-cp-你的API密鑰",
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7"
  },
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "git",
        "url": "https://github.com/affaan-m/everything-claude-code.git"
      }
    },
    "superpowers-marketplace": {
      "source": {
        "source": "git",
        "url": "https://github.com/obra/superpowers-marketplace.git"
      }
    }
  },
  "language": "zh-cn"
}

關(guān)于跳過官方登錄： 只要 env 中配置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL，Claude Code 啟動(dòng)時(shí)就不會(huì)要求官方 Anthropic 賬號(hào)登錄，直接使用配置的第三方 API。

5.3 配置文件優(yōu)先級(jí)機(jī)制（重要）

Claude Code 的 settings.json 讀取遵循降級(jí)策略：

行為規(guī)則：

• 當(dāng)默認(rèn)路徑 ~/.claude/settings.json 不存在時(shí) → 讀取 CLAUDE_CONFIG_DIR 下的配置。
• 當(dāng) ccswitch 創(chuàng)建了默認(rèn)路徑的配置后 → 默認(rèn)路徑優(yōu)先生效，覆蓋 CLAUDE_CONFIG_DIR。
• 兩者并存不沖突，ccswitch 正常工作。
• ccswitch 生成的配置內(nèi)容是完整正確的，不是只改了模型字段。

六、 驗(yàn)證

6.1 新終端中驗(yàn)證（重要：必須新開終端）

環(huán)境變量修改后已打開的終端不會(huì)自動(dòng)刷新，必須新開終端窗口：

# 新開的 PowerShell 終端中直接執(zhí)行
claude --version
# 輸出: 2.1.150 (Claude Code)

6.2 測(cè)試 API 連通性

echo "回復(fù)OK兩個(gè)字" | claude -p "回復(fù)OK兩個(gè)字"
# 應(yīng)返回: OK

6.3 若當(dāng)前終端找不到 claude 命令

環(huán)境變量修改后已打開的終端不會(huì)自動(dòng)刷新 PATH，可手動(dòng)刷新當(dāng)前會(huì)話：

$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "User") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "Machine")
$env:CLAUDE_CONFIG_DIR = "D:\app\Claude-code\data"

七、 踩坑經(jīng)驗(yàn)總結(jié)

7.1 ANTHROPIC_* 系統(tǒng)環(huán)境變量會(huì)覆蓋配置文件

• 問題：如果將 ANTHROPIC_AUTH_TOKEN 等設(shè)為用戶級(jí)系統(tǒng)環(huán)境變量，它們會(huì)覆蓋 settings.json 中的同名配置。
• 影響：ccswitch 切換模型不生效；手動(dòng)修改 settings.json 不生效。
• 解決：只通過 settings.json 的 env 字段管理這些變量，不設(shè)系統(tǒng)環(huán)境變量。

如果已誤設(shè)，清除方法：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", $null, "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", $null, "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", $null, "User")

7.2 PowerShell 終端不自動(dòng)刷新用戶級(jí) PATH

問題：通過 [System.Environment]::SetEnvironmentVariable(...) 設(shè)置的環(huán)境變量寫入注冊(cè)表，但不會(huì)立即在已打開的終端中生效。

解決：必須新開終端窗口?；蛟诋?dāng)前終端手動(dòng)刷新：

$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "User") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "Machine")

7.3 .claude.json 不受 CLAUDE_CONFIG_DIR 控制

C:\Users\Administrator\.claude.json 是固定路徑的用戶狀態(tài)文件，與 CLAUDE_CONFIG_DIR 無關(guān)。該文件始終在 C 盤用戶目錄下創(chuàng)建和讀取，體積很小，不用管它。

7.4 settings.json 的降級(jí)讀取邏輯

• CLAUDE_CONFIG_DIR 控制 sessions、cache、history 等大文件存儲(chǔ)位置。
• ~/.claude/settings.json（默認(rèn)路徑）在讀取優(yōu)先級(jí)上高于 CLAUDE_CONFIG_DIR/settings.json。
• 兩者是降級(jí)關(guān)系，不是互斥關(guān)系。
• ccswitch 寫入默認(rèn)路徑后自動(dòng)生效，不需要額外操作。

7.5 claude.cmd 不支持 --no-input 選項(xiàng)

非交互式調(diào)用不能使用 --no-input，需通過管道方式：

echo "你的prompt" | claude -p "你的prompt"

7.6 清理前必須備份

刪除 .claude\ 目錄前，務(wù)必先備份 settings.json（含 API 配置）和其他重要文件，否則需要重新配置所有 API 參數(shù)和插件設(shè)置。

八、 最終文件清單

C 盤保留文件

• C:\Users\Administrator\.claude.json — 用戶狀態(tài)文件（保留，不可控制位置）
• C:\Users\Administrator\.claude\settings.json — ccswitch 使用時(shí)會(huì)自動(dòng)創(chuàng)建（正常，高優(yōu)先級(jí)）

D 盤安裝文件

• D:\app\Claude-code\node_modules\ — Claude Code 程序本體
• D:\app\Claude-code\data\settings.json — 兜底配置文件
• D:\app\Claude-code\data\sessions\ — 會(huì)話數(shù)據(jù)（自動(dòng)創(chuàng)建）
• D:\app\Claude-code\data\cache\ — 緩存數(shù)據(jù)（自動(dòng)創(chuàng)建）
• D:\app\Claude-code\data\plugins\ — 插件數(shù)據(jù)（自動(dòng)創(chuàng)建）
• D:\app\Claude-code\settings.json.bak — 舊配置備份（可刪）
• D:\app\Claude-code\statusline-command.sh.bak — 舊狀態(tài)欄腳本備份（可刪）

用戶環(huán)境變量（僅兩項(xiàng)）

• CLAUDE_CONFIG_DIR = D:\app\Claude-code\data
• PATH 中包含 D:\app\Claude-code\node_modules\.bin

九、 后續(xù)維護(hù)

9.1 升級(jí) Claude Code

npm update --prefix "D:\app\Claude-code" @anthropic-ai/claude-code
# 或指定版本
npm install --prefix "D:\app\Claude-code" @anthropic-ai/claude-code@2.2.0

9.2 切換模型

兩種方式：

1. ccswitch（推薦）：自動(dòng)修改 C:\Users\Administrator\.claude\settings.json，高優(yōu)先級(jí)直接生效。
2. 手動(dòng)編輯：修改 D:\app\Claude-code\data\settings.json 中 env 字段的模型名稱（需確保默認(rèn)路徑配置不存在或已同步修改）。

9.3 完全卸載

# 刪除安裝目錄
Remove-Item -Path "D:\app\Claude-code" -Recurse -Force

# 刪除環(huán)境變量
[System.Environment]::SetEnvironmentVariable("CLAUDE_CONFIG_DIR", $null, "User")

# 從 PATH 中移除
$path = [System.Environment]::GetEnvironmentVariable("Path", "User")
$path = $path -replace [regex]::Escape("D:\app\Claude-code\node_modules\.bin;"), ""
[System.Environment]::SetEnvironmentVariable("Path", $path, "User")

# 可選：刪除用戶狀態(tài)和默認(rèn)路徑配置
Remove-Item "C:\Users\Administrator\.claude.json" -Force
Remove-Item "C:\Users\Administrator\.claude" -Recurse -Force -ErrorAction SilentlyContinue

十、 高級(jí)配置與擴(kuò)展指南

在完成基礎(chǔ)遷移與驗(yàn)證后，以下進(jìn)階內(nèi)容可幫助你進(jìn)一步定制 Claude Code 的使用體驗(yàn)，涵蓋插件管理、狀態(tài)欄自定義及多環(huán)境切換。

10.1 插件市場管理與安裝

文檔中配置的 extraKnownMarketplaces 僅為聲明市場源，實(shí)際安裝插件需通過命令行或交互式界面完成。

查看可用插件列表：

claude plugins list --marketplace everything-claude-code

安裝指定插件：

claude plugins install <plugin-name>@<marketplace-name>
# 示例：安裝 superpowers 市場的代碼審查插件
claude plugins install code-review@superpowers-marketplace

禁用/啟用已安裝插件：直接編輯 D:\app\Claude-code\data\settings.json 中的 enabledPlugins 字段，將對(duì)應(yīng)插件值設(shè)為 false 即可臨時(shí)禁用，無需卸載。

10.2 狀態(tài)欄自定義腳本

備份的 statusline-command.sh 是 Claude Code 終端狀態(tài)欄的自定義腳本，支持顯示當(dāng)前模型、Token 消耗、Git 分支等信息。

將備份腳本復(fù)制到 D 盤數(shù)據(jù)目錄：

Copy-Item "D:\app\Claude-code\statusline-command.sh.bak" "D:\app\Claude-code\data\statusline-command.sh"

編輯腳本內(nèi)容，支持 Bash 語法，輸出內(nèi)容會(huì)實(shí)時(shí)渲染在終端底部狀態(tài)欄。

若腳本未生效，檢查文件編碼是否為 UTF-8 無 BOM，Windows 下建議使用 VS Code 轉(zhuǎn)換編碼。

10.3 多 API 環(huán)境快速切換

除 ccswitch 外，可通過創(chuàng)建多個(gè)配置文件實(shí)現(xiàn)開發(fā)/測(cè)試環(huán)境的快速切換，避免頻繁修改主配置。

在 D:\app\Claude-code\data\ 下創(chuàng)建備用配置：

Copy-Item "D:\app\Claude-code\data\settings.json" "D:\app\Claude-code\data\settings.dev.json"

修改備用配置中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 為測(cè)試環(huán)境參數(shù)。

切換時(shí)僅需重命名文件，或通過臨時(shí)環(huán)境變量覆蓋（僅當(dāng)前會(huì)話生效）：

$env:CLAUDE_SETTINGS_PATH = "D:\app\Claude-code\data\settings.dev.json"
claude

十一、 常見問題排查手冊(cè)

十二、 安全與維護(hù)建議

1. API 密鑰安全：settings.json 中包含明文 API 密鑰，請(qǐng)勿將該文件提交至公開倉庫。建議在 Git 項(xiàng)目中添加 .claude/ 和 settings.json 到 .gitignore。
2. 定期清理緩存：D:\app\Claude-code\data\cache\ 和 sessions\ 會(huì)隨使用持續(xù)增長，可每月手動(dòng)清理過期文件，或編寫定時(shí)任務(wù)自動(dòng)清理 30 天前的會(huì)話數(shù)據(jù)。
3. 配置版本管理：建議將 settings.json 納入私有 Git 倉庫管理，記錄每次修改歷史，方便回滾誤操作。
4. 升級(jí)前備份：執(zhí)行 npm update 前，務(wù)必備份 data/settings.json，防止新版本覆蓋自定義配置。
5. 權(quán)限最小化：D 盤安裝目錄僅當(dāng)前用戶需要讀寫權(quán)限，無需管理員權(quán)限，避免惡意程序篡改核心文件。

結(jié)語

本指南完整覆蓋了 Claude Code 在 Windows 環(huán)境下從 C 盤遷移至 D 盤的全生命周期操作，從環(huán)境準(zhǔn)備、卸載備份、安裝配置到驗(yàn)證維護(hù)、進(jìn)階擴(kuò)展，所有步驟均基于官方文檔與實(shí)測(cè)經(jīng)驗(yàn)整理。遵循本指南可實(shí)現(xiàn)程序與系統(tǒng)盤的徹底解耦，同時(shí)保留完整的個(gè)性化配置與插件生態(tài)。建議在操作前通讀全文，重點(diǎn)標(biāo)記警告與避坑章節(jié)，確保遷移過程平穩(wěn)無誤。

以上就是Windows環(huán)境下Claude Code從C盤遷移至D盤的完整操作教程的詳細(xì)內(nèi)容，更多關(guān)于Claude Code遷移的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論