Claude Code 安裝

在 IT 圈，Claude Code 早已如雷貫耳，作為一個(gè)軟件開(kāi)發(fā)者，如果還不知道它，多少有點(diǎn)落后了

安裝很簡(jiǎn)單

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows PowerShell 可以按 Win 鍵，然后搜索它

打開(kāi)之后是這個(gè)樣子

跟 CMD 是不是很像？但它比 CMD 強(qiáng)大很多

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

我以 Win10 為例，通過(guò) Windows PowerShell 來(lái)安裝，不出意外的話會(huì)安裝失敗

因?yàn)?Claude 公司（Anthropic）對(duì)中國(guó)區(qū)采取了嚴(yán)格封鎖措施，所以用

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

會(huì)安裝失敗。既然此路不通，那我們就換條路，用 npm 方式安裝；安裝 Claude Code 之前，我們需要先安裝另外兩個(gè)工具

Git （僅 Windows 需要，Mac / Linux 跳過(guò)）

Claude Code 原生是為 Linux / macOS 設(shè)計(jì)的，而 Windows 系統(tǒng)命令不同，所以需要裝 Git 完成命令的兼容轉(zhuǎn)換；從Git 官網(wǎng)下載，安裝的時(shí)候一直下一步就行。安裝完成之后，我們可以在 cmd 中輸入命令：

git -v

查看安裝的 Git 版本

C:\Users\99791>git -v
git version 2.54.0.windows.1

Node

因?yàn)?npm 依賴 Node，所以我們得安裝 Node；從Node 官網(wǎng)下載，安裝的時(shí)候一直下一步，安裝完成之后，我們可以查看它們的版本

C:\Users\99791>node -v
v24.15.0

C:\Users\99791>npm -v
11.12.1

接下來(lái)安裝 Claude Code 就簡(jiǎn)單了，在 cmd 下執(zhí)行命令

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

順利的話，會(huì)輸出如下信息

C:\Users\99791>npm install -g @anthropic-ai/claude-code

added 2 packages in 12s

沒(méi)報(bào)錯(cuò)就說(shuō)明安裝成功了，我們看下 Claude Code 版本

C:\Users\99791>claude --version
2.1.139 (Claude Code)

如果 npm 安裝過(guò)程比較久甚至直接超時(shí)，我們可以先設(shè)置國(guó)內(nèi)鏡像

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

然后再用 npm 安裝 Claude Code

安裝好之后，接下來(lái)就是使用 Claude，直接在 cmd 下輸入 claude，然后回車(chē)，我們會(huì)發(fā)現(xiàn)啟動(dòng)失敗

Claude 默認(rèn)會(huì)用它自己的大模型，但它做了區(qū)域限制，中國(guó)區(qū)就被嚴(yán)格封鎖了。所以我們需要給 Claude 配置中國(guó)區(qū)支持的大模型

阿里云百煉

大模型都是要收費(fèi)的，但很多提供了免費(fèi)試用額度，比如阿里云百煉中的很多大模型

看中我們要使用的大模型后，將右側(cè)的 免費(fèi)額度用完即停 開(kāi)關(guān)開(kāi)啟，100萬(wàn) token 一下就用完了，不開(kāi)啟的話，就會(huì)扣你賬戶里面的錢(qián)了；最簡(jiǎn)單的方式，選 批量開(kāi)啟

然后 一鍵開(kāi)啟所有模型

登錄阿里云之后呢，先配置好 API Key

然后我們就可以選其中某個(gè)模型（例如：qwen-math-turbo）配置到 Claude，

1.修改 settings.json

通常位于用戶主目錄的 .claude 目錄下

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

如果文件不存在，則直接創(chuàng)建一個(gè)，例如我的 C:\Users\99791.claude\setting.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_MODEL": "大模型名"
  }
}

這三個(gè)配置項(xiàng)需要改成你們自己的

ANTHROPIC_BASE_URL

大模型兼容 Anthropic 規(guī)范的基本地址

阿里云百煉的地址是：https://dashscope.aliyuncs.com/apps/anthropic

其他模型提供商可以按上圖類(lèi)似的方式獲取

• DeepSeek：https://api.deepseek.com/anthropic
• 智譜AI（GLM）：https://open.bigmodel.cn/api/anthropic
• Kimi：https://api.kimi.com/coding
• MiniMax：https://api.minimaxi.com/anthropic
• Doubao：https://ark.cn-beijing.volces.com/api/coding
• Qianwen：https://dashscope.aliyuncs.com/apps/anthropic
• Hunyuan：https://api.hunyuan.cloud.tencent.com/anthropic

ANTHROPIC_AUTH_TOKEN：就是我們前面配置好的 API Key，作為 Claude 與大模型通信的鑒權(quán)憑證

ANTHROPIC_MODEL：配置我們前面選中的模型，示例中是：qwen-math-turbo

2.修改 .claude.json

通常位于用戶主目錄下，例如我的：C:\Users\99791.claude.json

在最后追加配置項(xiàng)：hasCompletedOnboarding，將其設(shè)置成 true，Claude Code 啟動(dòng)時(shí)會(huì)直接跳過(guò)新手引導(dǎo)（例如登錄、網(wǎng)絡(luò)校驗(yàn)等），進(jìn)入正常工作模式。配置完后，.claude.json 配置項(xiàng)大致如下

{
  "firstStartTime": "2026-05-11T08:36:03.501Z",
  "opusProMigrationComplete": true,
  "sonnet1m45MigrationComplete": true,
  "seenNotifications": {},
  "migrationVersion": 13,
  "userID": "62fcb0ea393536eae5bcec7042e8defc4b3d838bb703b1130b78b378e3cdd70c",
  "changelogLastFetched": 1778635280930,
  "hasCompletedOnboarding": true
}

json 文件內(nèi)容有格式限制，追加 hasCompletedOnboarding 的時(shí)候，要在上一個(gè)配置項(xiàng)的末尾添加一個(gè)英文逗號(hào)！?。?/p>

我們新開(kāi) cmd 窗口，啟動(dòng) Claude 不報(bào)錯(cuò)了，會(huì)讓我們確認(rèn)工作空間是否可信

我們選擇 1，回車(chē)后讓我們選擇是否使用我們自定義的 API Key，毫無(wú)疑問(wèn)選擇 1. yes，回車(chē)后 Claude Code 啟動(dòng)成功

我們輸入命令：/model，就可以看到我們配置的大模型（qwen-math-turbo）了

至此，配置算是完成了。我們可以和 Claude 對(duì)話了，不幸運(yùn)的話，你們會(huì)和我一樣，對(duì)話失敗

這是因?yàn)?qwen-math-turbo 并未實(shí)現(xiàn)對(duì) Anthropic 的兼容，兼容的模型只包含如下這些

我們換 deepseek-v4-pro 試試，只需要將 Claude settings.json 中的 ANTHROPIC_MODEL 配置項(xiàng)值調(diào)整成 deepseek-v4-pro 即可。在 Claude 終端輸入 exit 退出 Claude 后，再啟動(dòng) Claude

模型切換成功，可以和 Claude 正常對(duì)話了；對(duì)話的時(shí)候，盡量把背景描述清楚，對(duì)輸出也要求更細(xì)致，如果我們泛泛而問(wèn)，它自然也就泛泛而答了

token 消耗是非?？斓模欢ㄒ⒁饽銈兊?token 額度，如果是白嫖的話，一定要把 免費(fèi)額度用完即停 開(kāi)啟，100萬(wàn)免費(fèi) token 分分鐘就用完了

CC SWITCH

對(duì)于 Claude Code 的自定義模型配置，直接改 settings.json 是不是不夠方便，特別是在不同的提供商來(lái)回切換時(shí)，格外不便捷。所以，切換工具應(yīng)運(yùn)而生，CC Switch 就是其中之一，直接下載最新版安裝即可

安裝完后啟動(dòng)，界面如下

第一個(gè) Claude Official 是 Claude 模型，CC Switch 內(nèi)置的，國(guó)內(nèi)用不了，我們可以直接刪掉。第二個(gè) default，下面的 https 地址看著眼熟嗎，編輯下它就知道了，就是我們?cè)?Claude settings.json 中配置的模型，CC Swith讀取了而已

CC Switch 內(nèi)置了很多主流模型供應(yīng)商配置

我們配置這些內(nèi)置的供應(yīng)商時(shí)，只需要配置API Key即可

如果我們使用的是自定義，那么必配的項(xiàng)包括

• API Key
• 請(qǐng)求地址，也就是前面提到的 ANTHROPIC_BASE_URL
• 模型映射

其他的配置項(xiàng)保持默認(rèn)即可

想使用哪個(gè)模型，直接啟用他即可

切換非常方便。當(dāng)然，CC Switch 的功能遠(yuǎn)不止切換模型，詳情可查看官方說(shuō)明

當(dāng)我們切換模型后，要退出 Claude 再重新啟動(dòng)，就可以看到生效的是切換后的模型了

總結(jié)

Claude Code 安裝并接入自定義模型，其實(shí)很簡(jiǎn)單，耐心、細(xì)致點(diǎn)，都能搭建好。難的是如何用對(duì)、用好（laude CodeAI），另外就是 token 額度問(wèn)題，如果公司能夠幫我們買(mǎi)單，那是最好了，自費(fèi)的話，可能會(huì)是一筆不小的開(kāi)銷(xiāo)

到此這篇關(guān)于Claude Code安裝并接入阿里云百煉模型的完整教學(xué)的文章就介紹到這了,更多相關(guān)Claude Code安裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論