Claude Code安裝并接入阿里云百煉模型的完整教學(xué)
Claude Code 安裝
在 IT 圈,Claude Code 早已如雷貫耳,作為一個軟件開發(fā)者,如果還不知道它,多少有點(diǎn)落后了
安裝很簡單
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows PowerShell 可以按 Win 鍵,然后搜索它

打開之后是這個樣子

跟 CMD 是不是很像?但它比 CMD 強(qiáng)大很多
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
我以 Win10 為例,通過 Windows PowerShell 來安裝,不出意外的話會安裝失敗

因?yàn)?Claude 公司(Anthropic)對中國區(qū)采取了嚴(yán)格封鎖措施,所以用
irm https://claude.ai/install.ps1 | iex
會安裝失敗。既然此路不通,那我們就換條路,用 npm 方式安裝;安裝 Claude Code 之前,我們需要先安裝另外兩個工具
Git (僅 Windows 需要,Mac / Linux 跳過)
Claude Code 原生是為 Linux / macOS 設(shè)計的,而 Windows 系統(tǒng)命令不同,所以需要裝 Git 完成命令的兼容轉(zhuǎn)換;從Git 官網(wǎng)下載,安裝的時候一直下一步就行。安裝完成之后,我們可以在 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)下載,安裝的時候一直下一步,安裝完成之后,我們可以查看它們的版本
C:\Users\99791>node -v v24.15.0 C:\Users\99791>npm -v 11.12.1
接下來安裝 Claude Code 就簡單了,在 cmd 下執(zhí)行命令
npm install -g @anthropic-ai/claude-code
順利的話,會輸出如下信息
C:\Users\99791>npm install -g @anthropic-ai/claude-code added 2 packages in 12s
沒報錯就說明安裝成功了,我們看下 Claude Code 版本
C:\Users\99791>claude --version 2.1.139 (Claude Code)

如果 npm 安裝過程比較久甚至直接超時,我們可以先設(shè)置國內(nèi)鏡像
npm config set registry https://registry.npmmirror.com/
然后再用 npm 安裝 Claude Code
安裝好之后,接下來就是使用 Claude,直接在 cmd 下輸入 claude,然后回車,我們會發(fā)現(xiàn)啟動失敗

Claude 默認(rèn)會用它自己的大模型,但它做了區(qū)域限制,中國區(qū)就被嚴(yán)格封鎖了。所以我們需要給 Claude 配置中國區(qū)支持的大模型
阿里云百煉
大模型都是要收費(fèi)的,但很多提供了免費(fèi)試用額度,比如阿里云百煉中的很多大模型

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

然后 一鍵開啟所有模型

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

然后我們就可以選其中某個模型(例如:qwen-math-turbo)配置到 Claude,
1.修改 settings.json
通常位于用戶主目錄的 .claude 目錄下
- macOS / Linux:
~/.claude/settings.json - Windows:
%USERPROFILE%\.claude\settings.json
如果文件不存在,則直接創(chuàng)建一個,例如我的 C:\Users\99791.claude\setting.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your-api-key",
"ANTHROPIC_MODEL": "大模型名"
}
}這三個配置項(xiàng)需要改成你們自己的
ANTHROPIC_BASE_URL
大模型兼容 Anthropic 規(guī)范的基本地址
阿里云百煉的地址是:https://dashscope.aliyuncs.com/apps/anthropic

其他模型提供商可以按上圖類似的方式獲取
- 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ǎ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 的時候,要在上一個配置項(xiàng)的末尾添加一個英文逗號?。。?/p>
我們新開 cmd 窗口,啟動 Claude 不報錯了,會讓我們確認(rèn)工作空間是否可信

我們選擇 1,回車后讓我們選擇是否使用我們自定義的 API Key,毫無疑問選擇 1. yes,回車后 Claude Code 啟動成功

我們輸入命令:/model,就可以看到我們配置的大模型(qwen-math-turbo)了

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

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

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

模型切換成功,可以和 Claude 正常對話了;對話的時候,盡量把背景描述清楚,對輸出也要求更細(xì)致,如果我們泛泛而問,它自然也就泛泛而答了
token 消耗是非常快的,一定要注意你們的 token 額度,如果是白嫖的話,一定要把 免費(fèi)額度用完即停 開啟,100萬免費(fèi) token 分分鐘就用完了
CC SWITCH
對于 Claude Code 的自定義模型配置,直接改 settings.json 是不是不夠方便,特別是在不同的提供商來回切換時,格外不便捷。所以,切換工具應(yīng)運(yùn)而生,CC Switch 就是其中之一,直接下載最新版安裝即可
安裝完后啟動,界面如下

第一個 Claude Official 是 Claude 模型,CC Switch 內(nèi)置的,國內(nèi)用不了,我們可以直接刪掉。第二個 default,下面的 https 地址看著眼熟嗎,編輯下它就知道了,就是我們在 Claude settings.json 中配置的模型,CC Swith讀取了而已
CC Switch 內(nèi)置了很多主流模型供應(yīng)商配置

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

如果我們使用的是自定義,那么必配的項(xiàng)包括
- API Key
- 請求地址,也就是前面提到的 ANTHROPIC_BASE_URL
- 模型映射
其他的配置項(xiàng)保持默認(rèn)即可
想使用哪個模型,直接啟用他即可

切換非常方便。當(dāng)然,CC Switch 的功能遠(yuǎn)不止切換模型,詳情可查看官方說明
當(dāng)我們切換模型后,要退出 Claude 再重新啟動,就可以看到生效的是切換后的模型了

總結(jié)
Claude Code 安裝并接入自定義模型,其實(shí)很簡單,耐心、細(xì)致點(diǎn),都能搭建好。難的是如何用對、用好(laude CodeAI),另外就是 token 額度問題,如果公司能夠幫我們買單,那是最好了,自費(fèi)的話,可能會是一筆不小的開銷
到此這篇關(guān)于Claude Code安裝并接入阿里云百煉模型的完整教學(xué)的文章就介紹到這了,更多相關(guān)Claude Code安裝內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
本文主要介紹了Claude Code Desktop桌面版的安裝和使用,文中通過圖文介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)2026-05-14
2026年Claude Code中文教程指南入門:Mac/Windows安裝配置全攻略
Claude Code 是 Anthropic 于2025年推出的 終端原生AI編程助手,與傳統(tǒng)的IDE插件不同,它直接運(yùn)行在命令行中,本文我們就來看看如何在Mac/Windows系統(tǒng)下安裝與配置Claude Co2026-05-12
2026年最值得安裝的10個Claude Code Skills推薦
ClaudeCodeSkills是ClaudeCode的擴(kuò)展能力系統(tǒng),通過安裝特定的Skills,讓AI在特定領(lǐng)域表現(xiàn)得更專業(yè),文章介紹了10個精選Skills,涵蓋編程、設(shè)計、內(nèi)容創(chuàng)作、營銷、辦公等領(lǐng)域,2026-05-09
Claude Code 是 Anthropic 推出的官方 AI 編程助手,支持命令行、IDE 擴(kuò)展等多種使用方式,本文將詳細(xì)介紹在 Windows 系統(tǒng)上安裝和配置 Claude Code 的完整流程,幫助開發(fā)者2026-05-09
本地安裝Claude Code+自定義API接口的全配置指南
Claude Code 是Anthropic官方推出的AI 編程助手,可以直接在終端、VS Code、JetBrains 等 IDE 中使用,本文詳細(xì)介紹了Claude Code的安裝方法、環(huán)境要求、首次登錄步驟以及如2026-05-06
文章詳細(xì)介紹了安裝Claude-code的過程,包括安裝Node.js和Git,配置Git環(huán)境變量,使用npm安裝Claude-code,處理下載慢的問題,設(shè)置代理,配置API密鑰和環(huán)境變量等步驟,感興趣的2026-04-30
OpenCode安裝及配置Claude Opus 4.6模型完整指南
本文介紹了如何從零開始在不同操作系統(tǒng)上安裝并配置OpenCode,這是一款100%開源的AI編碼代理,文章詳細(xì)解釋了使用NodeJS安裝、配置模型以及安裝antigravity+geminiclioauth插2026-04-29
Claude Code + IDEA 的沉浸式編程實(shí)踐方案
ClaudeCode是Anthropicc推出的AI編程搭檔,具備上下文感知、工程化導(dǎo)向和可定制行為特征,本文介紹了其安裝配置、與第三方平臺CodingPlan的的集成,并通過IDE插件在Idea中使用2026-04-27
Claude Code 官方棄用 npm 安裝方式的原因分析與完整遷移指南
文章分析了Anthropic公司棄用通過npm安裝ClaudeCode方式的原因,文中提供了詳細(xì)的原生安裝指南和現(xiàn)有npm用戶的遷移指南,以及常見問題和解決方案,最終,文章強(qiáng)調(diào)原生安裝方式2026-04-24
一文教你徹底解決Claude Code安裝報錯問題:完整清理與重裝指南
很多開發(fā)者在按照官方文檔安裝@anthropic-ai/claude-code時遇到報錯問題,即使完全按照步驟操作仍然無法解決,本文將分享一個完整的解決方案,包含關(guān)鍵清理步驟和重裝流程,2026-04-23











