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