背景：作為一個(gè)前端開(kāi)發(fā)，已經(jīng)深刻感受到 AI 帶來(lái)的沖擊，若不積極擁抱 AI , 一定會(huì)被 AI 的浪潮拍死在沙灘上，接下來(lái)就研究一下如何安裝 Claude code。了解過(guò)官網(wǎng)中的 Claude code 的小伙伴都知道目前 Claude 僅支持部分地區(qū)可用，至少目前大陸地區(qū)無(wú)法直接使用，但是我們可以通過(guò)其它方式來(lái)使用 claude code。

方案一：API 中轉(zhuǎn)/代理服務(wù)

原理：通過(guò)國(guó)內(nèi)服務(wù)商提供的中轉(zhuǎn)地址調(diào)用 Claude API，服務(wù)商負(fù)責(zé)與官方服務(wù)器通信
優(yōu)點(diǎn)：網(wǎng)絡(luò)穩(wěn)定、支持支付寶/微信支付、一個(gè) Key 可用多種模型
缺點(diǎn)：有額外費(fèi)用、依賴第三方服務(wù)商的穩(wěn)定性
適合人群：絕大多數(shù)開(kāi)發(fā)者，需要 API 集成或穩(wěn)定使用的用戶。

注意：國(guó)內(nèi)的中轉(zhuǎn)平臺(tái)非常多，可以選擇自己喜歡的，本文章使用是七牛云作為中轉(zhuǎn)平臺(tái)

步驟一：注冊(cè)七牛云賬號(hào)

方法1：官網(wǎng)注冊(cè)
點(diǎn)擊訪問(wèn) 七牛云官網(wǎng) 點(diǎn)擊進(jìn)行注冊(cè)，并進(jìn)行實(shí)名認(rèn)證

注意： 七牛云官網(wǎng) 此鏈接包含邀請(qǐng)碼，通過(guò)此鏈接創(chuàng)建第一個(gè) KEY 時(shí)，即激活當(dāng)前賬號(hào)的 1000 萬(wàn)免費(fèi) Token 額度，若自行通過(guò)官網(wǎng)注冊(cè)并創(chuàng)建第一個(gè) KEY 時(shí)，即激活當(dāng)前賬號(hào)的 300 萬(wàn)免費(fèi) Token 額度

方法2：微信小程序注冊(cè)
打開(kāi)微信，搜索 “七牛云” 小程序
點(diǎn)擊 “手機(jī)號(hào)快捷登錄” 完成注冊(cè)
進(jìn)入小程序，進(jìn)入小程序后，點(diǎn)擊底部 【我的】 → 【我的控制臺(tái)】

注意：若自行通過(guò)官網(wǎng)注冊(cè)并創(chuàng)建第一個(gè) KEY 時(shí)，即激活當(dāng)前賬號(hào)的 300 萬(wàn)免費(fèi) Token 額度，推薦使用 方法1 可以獲取 1000 萬(wàn)免費(fèi) Token 額度

步驟二：獲取 API Key

通過(guò)控制臺(tái)獲取

1. 在左側(cè)導(dǎo)航欄找到 「AI 大模型推理」，點(diǎn)擊進(jìn)入
2. 選擇 「API Key」 選項(xiàng)
3. 點(diǎn)擊 “創(chuàng)建密鑰”，輸入名稱（如“Claude Code”）

步驟三：配置 Claude Code

使用文檔.png

Windows 用戶

1. 右鍵 「此電腦」 → 「屬性」 → 「高級(jí)系統(tǒng)設(shè)置」 → 「環(huán)境變量」
2. 在 「用戶變量」 欄點(diǎn)擊 「新建」，添加以下變量：

ANTHROPIC_API_KEY: 你復(fù)制的七牛云 API Key
ANTHROPIC_BASE_URL: https://api.qnaigc.com

//  關(guān)鍵提醒：ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 只能配置一個(gè)，同時(shí)設(shè)置會(huì)導(dǎo)致鑒權(quán)失??！

3. 點(diǎn)擊 「確定」 保存
4. 關(guān)閉所有終端窗口并重新打開(kāi)，配置即可生效

步驟四：驗(yàn)證配置

1、確認(rèn) Claude Code 已安裝

// 打開(kāi)終端執(zhí)行命令：
claude -v

// 如果提示找不到命令，請(qǐng)先安裝 Claude Code
// 以管理員身份運(yùn)行（Windows需要）
npm install -g @anthropic-ai/claude-code

2、再次確認(rèn) Claude Code 是否已安裝

claude -v

// 可以正確顯示版本號(hào)即可

3、啟用 claude Code

// 打開(kāi)終端直接執(zhí)行命令
claude

步驟四：錯(cuò)誤處理

1、啟動(dòng) Claude Code 時(shí)若提示

Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

你遇到的這個(gè)報(bào)錯(cuò)是正常的，這是因?yàn)?Claude Code 在 Windows 上運(yùn)行時(shí)，需要依賴 Git Bash 來(lái)執(zhí)行各種 shell 命令， 系統(tǒng)找不到這個(gè)環(huán)境，就會(huì)報(bào)這個(gè)提示。

要解決這個(gè)問(wèn)題需要配置環(huán)境變量，明確告訴系統(tǒng) bash.exe 在哪里

解決步驟1：確認(rèn) Git 已正確安裝
首先，請(qǐng)確認(rèn)你已經(jīng)安裝了 Git for Windows。如果還沒(méi)安裝，可以從官網(wǎng)下載 https://git-scm.com/downloads/win 安裝時(shí)，請(qǐng)確保選中了 “Add Git to PATH”

解決步驟2：找到 bash.exe 文件
Git 安裝完成后，bash.exe 文件通常在這兩個(gè)位置之一

• C:\Program Files\Git\bin\bash.exe
• C:\Program Files (x86)\Git\bin\bash.exe

解決步驟三：設(shè)置環(huán)境變量
在“用戶變量”區(qū)域，點(diǎn)擊“新建”
在彈出的窗口中填寫(xiě)信息

CLAUDE_CODE_GIT_BASH_PATH: C:\Program Files\Git\bin\bash.exe

解決步驟四：重啟終端并驗(yàn)證
請(qǐng)務(wù)必完全關(guān)閉你當(dāng)前所有的 PowerShell 或命令提示符窗口，然后重新打開(kāi)一個(gè)新的。 這一步非常重要，因?yàn)榄h(huán)境變量需要重啟終端才能生效

2、啟動(dòng) Claude Code 時(shí)若提示

image.png

這個(gè)報(bào)錯(cuò)說(shuō)明 Claude Code 無(wú)法連接到 Anthropic 的官方服務(wù)器 api.anthropic.com。這在您所在地區(qū)是常見(jiàn)情況，但因?yàn)槲覀兪褂昧似吲Ｔ浦修D(zhuǎn)，所以需要配置 Claude Code 忽略默認(rèn)的官方地址，強(qiáng)制使用七牛云的 API 地址

配置 Claude Code 使用中轉(zhuǎn)服務(wù)，您需要手動(dòng)創(chuàng)建或修改配置文件，讓 Claude Code 知道應(yīng)該連接七牛云，而不是官方的 api.anthropic.com。

解決步驟1：找到并編輯配置文件

1. 在 Windows 的 PowerShell 或命令提示符中，運(yùn)行以下命令來(lái)創(chuàng)建或編輯配置文件

notepad "$env:USERPROFILE\.claude\settings.json"

// 如果提示“找不到文件”，選擇“是”來(lái)創(chuàng)建新文件。

2. 粘貼配置內(nèi)容
   打開(kāi)的記事本中，粘貼以下內(nèi)容。請(qǐng)務(wù)必將 your_qiniu_api_key_here 替換為您在七牛云獲取的真實(shí) API Key

// 這是一個(gè)json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_qiniu_api_key_here",
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com",
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

//  注意：CLAUDE_CODE_GIT_BASH_PATH 的值中，這里用的是 “\\” ，即第一個(gè) ‘\’ 的作用是將第二個(gè) ‘\’ 轉(zhuǎn)譯一下

3、處理可能存在的遺留引導(dǎo)配置
為防止 Claude Code 的首次啟動(dòng)引導(dǎo)程序（Onboarding）干擾連接，我們還可以創(chuàng)建一個(gè)文件來(lái)標(biāo)記引導(dǎo)已完成

// powershell

notepad "$env:USERPROFILE\.claude.json"

在打開(kāi)的新文件中，粘貼以下內(nèi)容：

// json

{
  "hasCompletedOnboarding": true
}

// 保存并關(guān)閉該文件

3、啟動(dòng) Claude Code 時(shí)若提示

image.png

為什么要選 "No"？
這個(gè)提示的意思是：Claude Code 檢測(cè)到你的環(huán)境變量中有一個(gè) API Key（很可能是之前配置的官方 Anthropic Key 或其他來(lái)源的 Key），但它和你通過(guò)七牛云中轉(zhuǎn)服務(wù)的配置方式不兼容

選擇 No 是指忽略這個(gè)檢測(cè)到的 Key，使用你在 settings.json 中配置的 ANTHROPIC_BASE_URL（七牛云中轉(zhuǎn)地址）

如何徹底清除這個(gè)沖突的 API Key
1、右鍵 「此電腦」 → 「屬性」 → 「高級(jí)系統(tǒng)設(shè)置」 → 「環(huán)境變量」
2、在 「用戶變量」 和 「系統(tǒng)變量」 中，查找 ANTHROPIC_API_KEY
3、如果找到，刪除它（因?yàn)槲覀円呀?jīng)改用 settings.json 中的配置）
4、點(diǎn)擊確定保存
刪除后，重啟終端再運(yùn)行 claude，就不會(huì)再看到這個(gè)提示了