前言在 AI 編程時(shí)代Claude Code憑借其強(qiáng)大的代碼理解與生成能力成為了開發(fā)者的利器。然而由于網(wǎng)絡(luò)環(huán)境和配置門檻許多開發(fā)者在初次接觸時(shí)往往望而卻步。本教程將帶你從零開始通過Claude Code CC Switch的組合輕松搭建一套穩(wěn)定、高效的 AI 編程工作流。第一步、前置環(huán)境準(zhǔn)備Git Node.jsClaude Code 的運(yùn)行依賴于基礎(chǔ)的命令行工具和 Node.js 環(huán)境在開始安裝前請確保你的電腦已具備以下條件1、安裝 GitClaude Code 底層依賴 Git Bash 執(zhí)行命令。Windows 用戶可通過 winget install Git.Git 或前往官網(wǎng)下載安裝macOS 用戶在終端輸入 git --version系統(tǒng)會(huì)自動(dòng)引導(dǎo)安裝。以下以Windows11系統(tǒng)為例1在Git官網(wǎng)下載安裝包推薦GIt Installhttps://git-scm.com/install/windows雙擊安裝包按默認(rèn)選項(xiàng)一路點(diǎn)擊「Next」完成安裝2檢驗(yàn)打開本地終端輸入git version可查看版本安裝成功2、安裝 Node.js推薦安裝 Node.js 18 LTS 或更高版本。安裝完成后在終端輸入 node --version 和 npm --version確認(rèn)能正常輸出版本號即可。1在Node.js官網(wǎng)下載安裝包長期更新版Node.js InstallNode.js? is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.https://nodejs.org/zh-cn/download2檢驗(yàn)安裝完成后在終端輸入node --version和npm --version確認(rèn)能正常輸出版本號即可。3附問題處理這個(gè)錯(cuò)誤是因?yàn)?Windows PowerShell 默認(rèn)的執(zhí)行策略禁止了腳本運(yùn)行導(dǎo)致 npm.ps1 無法被加載。這是系統(tǒng)安全機(jī)制的一部分但可以通過修改執(zhí)行策略來解決。以下是具體操作步驟1、以管理員身份打開 PowerShell2、查看當(dāng)前執(zhí)行策略在 PowerShell 中輸入以下命令并回車Get-ExecutionPolicy如果返回結(jié)果是 Restricted說明系統(tǒng)當(dāng)前禁止所有腳本運(yùn)行這就是導(dǎo)致報(bào)錯(cuò)的原因。3、修改執(zhí)行策略為允許本地腳本運(yùn)行輸入以下命令并回車Set-ExecutionPolicy RemoteSigned -Scope CurrentUser系統(tǒng)會(huì)提示你確認(rèn)是否更改策略輸入 Y 并回車即可。4、驗(yàn)證修改是否生效再次輸入Get-ExecutionPolicy如果返回結(jié)果是 RemoteSigned說明修改成功。第二步、獲取大模型 API Key以硅基流動(dòng)為例提前注冊并獲取硅基流動(dòng)的 API Key 和 Base URL并妥善保存在備忘錄中備用1獲取 API Key登錄硅基流動(dòng)官網(wǎng)進(jìn)入左側(cè)導(dǎo)航欄的「API 密鑰」頁面。點(diǎn)擊「新建 API 密鑰」輸入描述如“CC Switch 專用”生成后立即復(fù)制保存注意密鑰僅顯示一次不可找回且以sk-開頭。2記錄 Base URL硅基流動(dòng)兼容 OpenAI 格式的接口地址為https://api.siliconflow.cn/v1注意務(wù)必包含末尾的/v1。3確定模型名稱前往硅基流動(dòng)的「模型廣場」找到你需要的模型例如deepseek-ai/DeepSeek-V3或zai-org/GLM-4.6復(fù)制完整的模型 ID 備用。第三步、安裝 Claude Code CLIClaude Code 是 Anthropic 官方推出的智能體 CLI 工具也是整個(gè)工作流的核心引擎。1安裝打開終端macOS/CMDWindows管理員權(quán)限運(yùn)行輸入以下命令全局安裝npm install -g anthropic-ai/claude-code2檢查安裝完成后務(wù)必重啟終端然后輸入 claude --version。如果能正常輸出版本號說明安裝成功。若提示 command not foundWindows 用戶需手動(dòng)將 %USERPROFILE%\.claude\bin 添加到系統(tǒng)環(huán)境變量 Path 中。第四步、安裝并配置 CC Switch由于 Anthropic 官方接口在使用時(shí)直連極易超時(shí)我們需要借助CC Switch這一可視化管理工具來切換兼容的 API 供應(yīng)商。1下載與安裝前往 CC Switch 的官網(wǎng)根據(jù)你的操作系統(tǒng)下載對應(yīng)的安裝包。Github -- CC SwitchCC Switch 官方網(wǎng)站。統(tǒng)一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的供應(yīng)商配置、本地路由、MCP、Skills、會(huì)話與用量統(tǒng)計(jì)。https://github.com/farion1231/cc-switch/releasesWindows系統(tǒng)可選擇以下安裝包進(jìn)行下載安裝文件名適用設(shè)備類型安裝方式說明CC-Switch-v3.17.0-Windows-arm64-Portable.zipARM64 架構(gòu)設(shè)備如 Surface Pro X、部分輕薄本免安裝解壓即用便攜版適合U盤攜帶或臨時(shí)使用CC-Switch-v3.17.0-Windows-arm64.msiARM64 架構(gòu)設(shè)備標(biāo)準(zhǔn)安裝向?qū)?huì)寫入注冊表支持系統(tǒng)級卸載CC-Switch-v3.17.0-Windows-arm64.msi.sigARM64 架構(gòu)設(shè)備簽名文件用于驗(yàn)證 MSI 安裝包完整性非安裝程序CC-Switch-v3.17.0-Windows-Portable.zipx86_64 架構(gòu)設(shè)備主流Intel/AMD電腦免安裝解壓即用便攜版適合U盤攜帶或臨時(shí)使用CC-Switch-v3.17.0-Windows.msix86_64 架構(gòu)設(shè)備標(biāo)準(zhǔn)安裝向?qū)?huì)寫入注冊表支持系統(tǒng)級卸載CC-Switch-v3.17.0-Windows.msi.sigx86_64 架構(gòu)設(shè)備簽名文件用于驗(yàn)證 MSI 安裝包完整性非安裝程序2CC Switch 基礎(chǔ)配置1、選擇預(yù)設(shè)供應(yīng)商在 CC Switch 點(diǎn)擊號新增供應(yīng)商時(shí)可以直接在預(yù)設(shè)列表中選擇SiliconFlow硅基流動(dòng)這樣請求地址會(huì)自動(dòng)填充無需手動(dòng)輸入。2、填寫 API Key在 API Key 輸入框中粘貼你剛才復(fù)制的sk-xxxxxxxx密鑰。3、配置模型映射由于 Claude Code 原生主要支持 GPT 系列使用硅基流動(dòng)的模型如 DeepSeek需要開啟“本地路由映射”或“模型映射”功能5。在 CC Switch 的模型映射選項(xiàng)中點(diǎn)擊“獲取模型列表”它會(huì)自動(dòng)拉取硅基流動(dòng)支持的全部模型。然后選擇你需要的模型如deepseek-ai/DeepSeek-V3.2進(jìn)行映射即可。3檢測打開本地終端輸入以下代碼進(jìn)入Claude Code界面claude --dangerously-skip-permissions出現(xiàn)這個(gè)界面之后可以和它互動(dòng)一下例如發(fā)一個(gè) hi成功之后會(huì)回復(fù)給你消息。附Claude Code五種模式模式名稱狀態(tài)提示功能描述適用場景Plan Mode(計(jì)劃模式)plan mode on只讀與規(guī)劃模式。深入分析代碼庫、探索文件并運(yùn)行只讀命令但絕對不會(huì)修改任何文件。僅輸出文字方案、代碼思路或執(zhí)行計(jì)劃等待用戶確認(rèn)。架構(gòu)設(shè)計(jì)、大型重構(gòu)前的方案評估、代碼審查、分析敏感代碼或需要 AI “先謀后動(dòng)”時(shí)。Auto Mode(自動(dòng)模式)auto mode on智能自動(dòng)執(zhí)行模式。內(nèi)置風(fēng)險(xiǎn)分類器自動(dòng)檢測低風(fēng)險(xiǎn)常規(guī)操作自動(dòng)放行高危操作自動(dòng)攔截并預(yù)警。介于手動(dòng)確認(rèn)和完全免權(quán)限之間。老舊項(xiàng)目批量重構(gòu)、全局代碼規(guī)范統(tǒng)一、多文件 Bug 批量修復(fù)、自動(dòng)化腳本編寫等長耗時(shí)且風(fēng)險(xiǎn)相對可控的任務(wù)。Manual Mode(手動(dòng)/默認(rèn)模式)? for shortcuts(默認(rèn)狀態(tài))最安全、最基礎(chǔ)的交互模式。在嘗試修改文件或執(zhí)行終端命令前必須先停下來詢問用戶展示修改預(yù)覽并等待明確批準(zhǔn)如輸入/apply后才會(huì)執(zhí)行。新手入門、日常開發(fā)、修改核心業(yè)務(wù)邏輯或數(shù)據(jù)庫等關(guān)鍵功能、對 AI 生成代碼沒把握需要嚴(yán)格把關(guān)時(shí)。Accept Edits(接受編輯模式)accept edits on半自動(dòng)模式。可以自動(dòng)創(chuàng)建和修改代碼文件無需用戶手動(dòng)確認(rèn)但執(zhí)行 Shell 終端命令或網(wǎng)絡(luò)請求時(shí)仍需手動(dòng)確認(rèn)。編寫簡單的 CRUD 業(yè)務(wù)代碼、單元測試、批量替換變量、補(bǔ)充代碼注釋等已知安全且重復(fù)度高的文件編輯任務(wù)。Bypass Permissions(跳過權(quán)限模式)bypass permissions on(通常高亮顯示)極度危險(xiǎn)的“裸奔”模式。徹底跳過所有權(quán)限檢查和安全攔截全自動(dòng)操控電腦執(zhí)行任何文件讀寫和終端命令且無任何確認(rèn)彈窗。僅限完全隔離的沙箱環(huán)境如 Docker、虛擬機(jī)。用于修復(fù) Lint 錯(cuò)誤、生成樣板代碼等無需人工干預(yù)的自動(dòng)化流水線任務(wù)。嚴(yán)禁在生產(chǎn)環(huán)境使用。 最新保姆級教程：Claude Code + CC Switch 完美配置指南
前言在 AI 編程時(shí)代Claude Code憑借其強(qiáng)大的代碼理解與生成能力成為了開發(fā)者的利器。然而由于網(wǎng)絡(luò)環(huán)境和配置門檻許多開發(fā)者在初次接觸時(shí)往往望而卻步。本教程將帶你從零開始通過Claude Code CC Switch的組合輕松搭建一套穩(wěn)定、高效的 AI 編程工作流。第一步、前置環(huán)境準(zhǔn)備Git Node.jsClaude Code 的運(yùn)行依賴于基礎(chǔ)的命令行工具和 Node.js 環(huán)境在開始安裝前請確保你的電腦已具備以下條件1、安裝 GitClaude Code 底層依賴 Git Bash 執(zhí)行命令。Windows 用戶可通過 winget install Git.Git 或前往官網(wǎng)下載安裝macOS 用戶在終端輸入 git --version系統(tǒng)會(huì)自動(dòng)引導(dǎo)安裝。以下以Windows11系統(tǒng)為例1在Git官網(wǎng)下載安裝包推薦GIt Installhttps://git-scm.com/install/windows雙擊安裝包按默認(rèn)選項(xiàng)一路點(diǎn)擊「Next」完成安裝2檢驗(yàn)打開本地終端輸入git version可查看版本安裝成功2、安裝 Node.js推薦安裝 Node.js 18 LTS 或更高版本。安裝完成后在終端輸入 node --version 和 npm --version確認(rèn)能正常輸出版本號即可。1在Node.js官網(wǎng)下載安裝包長期更新版Node.js InstallNode.js? is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.https://nodejs.org/zh-cn/download2檢驗(yàn)安裝完成后在終端輸入node --version和npm --version確認(rèn)能正常輸出版本號即可。3附問題處理這個(gè)錯(cuò)誤是因?yàn)?Windows PowerShell 默認(rèn)的執(zhí)行策略禁止了腳本運(yùn)行導(dǎo)致 npm.ps1 無法被加載。這是系統(tǒng)安全機(jī)制的一部分但可以通過修改執(zhí)行策略來解決。以下是具體操作步驟1、以管理員身份打開 PowerShell2、查看當(dāng)前執(zhí)行策略在 PowerShell 中輸入以下命令并回車Get-ExecutionPolicy如果返回結(jié)果是 Restricted說明系統(tǒng)當(dāng)前禁止所有腳本運(yùn)行這就是導(dǎo)致報(bào)錯(cuò)的原因。3、修改執(zhí)行策略為允許本地腳本運(yùn)行輸入以下命令并回車Set-ExecutionPolicy RemoteSigned -Scope CurrentUser系統(tǒng)會(huì)提示你確認(rèn)是否更改策略輸入 Y 并回車即可。4、驗(yàn)證修改是否生效再次輸入Get-ExecutionPolicy如果返回結(jié)果是 RemoteSigned說明修改成功。第二步、獲取大模型 API Key以硅基流動(dòng)為例提前注冊并獲取硅基流動(dòng)的 API Key 和 Base URL并妥善保存在備忘錄中備用1獲取 API Key登錄硅基流動(dòng)官網(wǎng)進(jìn)入左側(cè)導(dǎo)航欄的「API 密鑰」頁面。點(diǎn)擊「新建 API 密鑰」輸入描述如“CC Switch 專用”生成后立即復(fù)制保存注意密鑰僅顯示一次不可找回且以sk-開頭。2記錄 Base URL硅基流動(dòng)兼容 OpenAI 格式的接口地址為https://api.siliconflow.cn/v1注意務(wù)必包含末尾的/v1。3確定模型名稱前往硅基流動(dòng)的「模型廣場」找到你需要的模型例如deepseek-ai/DeepSeek-V3或zai-org/GLM-4.6復(fù)制完整的模型 ID 備用。第三步、安裝 Claude Code CLIClaude Code 是 Anthropic 官方推出的智能體 CLI 工具也是整個(gè)工作流的核心引擎。1安裝打開終端macOS/CMDWindows管理員權(quán)限運(yùn)行輸入以下命令全局安裝npm install -g anthropic-ai/claude-code2檢查安裝完成后務(wù)必重啟終端然后輸入 claude --version。如果能正常輸出版本號說明安裝成功。若提示 command not foundWindows 用戶需手動(dòng)將 %USERPROFILE%\.claude\bin 添加到系統(tǒng)環(huán)境變量 Path 中。第四步、安裝并配置 CC Switch由于 Anthropic 官方接口在使用時(shí)直連極易超時(shí)我們需要借助CC Switch這一可視化管理工具來切換兼容的 API 供應(yīng)商。1下載與安裝前往 CC Switch 的官網(wǎng)根據(jù)你的操作系統(tǒng)下載對應(yīng)的安裝包。Github -- CC SwitchCC Switch 官方網(wǎng)站。統(tǒng)一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的供應(yīng)商配置、本地路由、MCP、Skills、會(huì)話與用量統(tǒng)計(jì)。https://github.com/farion1231/cc-switch/releasesWindows系統(tǒng)可選擇以下安裝包進(jìn)行下載安裝文件名適用設(shè)備類型安裝方式說明CC-Switch-v3.17.0-Windows-arm64-Portable.zipARM64 架構(gòu)設(shè)備如 Surface Pro X、部分輕薄本免安裝解壓即用便攜版適合U盤攜帶或臨時(shí)使用CC-Switch-v3.17.0-Windows-arm64.msiARM64 架構(gòu)設(shè)備標(biāo)準(zhǔn)安裝向?qū)?huì)寫入注冊表支持系統(tǒng)級卸載CC-Switch-v3.17.0-Windows-arm64.msi.sigARM64 架構(gòu)設(shè)備簽名文件用于驗(yàn)證 MSI 安裝包完整性非安裝程序CC-Switch-v3.17.0-Windows-Portable.zipx86_64 架構(gòu)設(shè)備主流Intel/AMD電腦免安裝解壓即用便攜版適合U盤攜帶或臨時(shí)使用CC-Switch-v3.17.0-Windows.msix86_64 架構(gòu)設(shè)備標(biāo)準(zhǔn)安裝向?qū)?huì)寫入注冊表支持系統(tǒng)級卸載CC-Switch-v3.17.0-Windows.msi.sigx86_64 架構(gòu)設(shè)備簽名文件用于驗(yàn)證 MSI 安裝包完整性非安裝程序2CC Switch 基礎(chǔ)配置1、選擇預(yù)設(shè)供應(yīng)商在 CC Switch 點(diǎn)擊號新增供應(yīng)商時(shí)可以直接在預(yù)設(shè)列表中選擇SiliconFlow硅基流動(dòng)這樣請求地址會(huì)自動(dòng)填充無需手動(dòng)輸入。2、填寫 API Key在 API Key 輸入框中粘貼你剛才復(fù)制的sk-xxxxxxxx密鑰。3、配置模型映射由于 Claude Code 原生主要支持 GPT 系列使用硅基流動(dòng)的模型如 DeepSeek需要開啟“本地路由映射”或“模型映射”功能5。在 CC Switch 的模型映射選項(xiàng)中點(diǎn)擊“獲取模型列表”它會(huì)自動(dòng)拉取硅基流動(dòng)支持的全部模型。然后選擇你需要的模型如deepseek-ai/DeepSeek-V3.2進(jìn)行映射即可。3檢測打開本地終端輸入以下代碼進(jìn)入Claude Code界面claude --dangerously-skip-permissions出現(xiàn)這個(gè)界面之后可以和它互動(dòng)一下例如發(fā)一個(gè) hi成功之后會(huì)回復(fù)給你消息。附Claude Code五種模式模式名稱狀態(tài)提示功能描述適用場景Plan Mode(計(jì)劃模式)plan mode on只讀與規(guī)劃模式。深入分析代碼庫、探索文件并運(yùn)行只讀命令但絕對不會(huì)修改任何文件。僅輸出文字方案、代碼思路或執(zhí)行計(jì)劃等待用戶確認(rèn)。架構(gòu)設(shè)計(jì)、大型重構(gòu)前的方案評估、代碼審查、分析敏感代碼或需要 AI “先謀后動(dòng)”時(shí)。Auto Mode(自動(dòng)模式)auto mode on智能自動(dòng)執(zhí)行模式。內(nèi)置風(fēng)險(xiǎn)分類器自動(dòng)檢測低風(fēng)險(xiǎn)常規(guī)操作自動(dòng)放行高危操作自動(dòng)攔截并預(yù)警。介于手動(dòng)確認(rèn)和完全免權(quán)限之間。老舊項(xiàng)目批量重構(gòu)、全局代碼規(guī)范統(tǒng)一、多文件 Bug 批量修復(fù)、自動(dòng)化腳本編寫等長耗時(shí)且風(fēng)險(xiǎn)相對可控的任務(wù)。Manual Mode(手動(dòng)/默認(rèn)模式)? for shortcuts(默認(rèn)狀態(tài))最安全、最基礎(chǔ)的交互模式。在嘗試修改文件或執(zhí)行終端命令前必須先停下來詢問用戶展示修改預(yù)覽并等待明確批準(zhǔn)如輸入/apply后才會(huì)執(zhí)行。新手入門、日常開發(fā)、修改核心業(yè)務(wù)邏輯或數(shù)據(jù)庫等關(guān)鍵功能、對 AI 生成代碼沒把握需要嚴(yán)格把關(guān)時(shí)。Accept Edits(接受編輯模式)accept edits on半自動(dòng)模式。可以自動(dòng)創(chuàng)建和修改代碼文件無需用戶手動(dòng)確認(rèn)但執(zhí)行 Shell 終端命令或網(wǎng)絡(luò)請求時(shí)仍需手動(dòng)確認(rèn)。編寫簡單的 CRUD 業(yè)務(wù)代碼、單元測試、批量替換變量、補(bǔ)充代碼注釋等已知安全且重復(fù)度高的文件編輯任務(wù)。Bypass Permissions(跳過權(quán)限模式)bypass permissions on(通常高亮顯示)極度危險(xiǎn)的“裸奔”模式。徹底跳過所有權(quán)限檢查和安全攔截全自動(dòng)操控電腦執(zhí)行任何文件讀寫和終端命令且無任何確認(rèn)彈窗。僅限完全隔離的沙箱環(huán)境如 Docker、虛擬機(jī)。用于修復(fù) Lint 錯(cuò)誤、生成樣板代碼等無需人工干預(yù)的自動(dòng)化流水線任務(wù)。嚴(yán)禁在生產(chǎn)環(huán)境使用。