前言在 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 错误、生成样板代码等无需人工干预的自动化流水线任务。严禁在生产环境使用。