前言        

        在 AI 编程时代，Claude Code 凭借其强大的代码理解与生成能力成为了开发者的利器。然而，由于网络环境和配置门槛，许多国内开发者在初次接触时往往望而却步。本教程将带你从零开始，通过 Claude Code + CC Switch 的组合，轻松搭建一套稳定、高效的国内 AI 编程工作流。

第一步、前置环境准备（Git + Node.js）

        Claude Code 的运行依赖于基础的命令行工具和 Node.js 环境，在开始安装前，请确保你的电脑已具备以下条件：

1、安装 Git

        Claude 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/download

 

（2）检验：

安装完成后，在终端输入 node --version 和 npm --version，确认能正常输出版本号即可。

（3）附：问题处理：

        这个错误是因为 Windows PowerShell 默认的执行策略禁止了脚本运行，导致 npm.ps1 无法被加载。这是系统安全机制的一部分，但可以通过修改执行策略来解决。以下是具体操作步骤：

1、以管理员身份打开 PowerShell

2、查看当前执行策略

在 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 CLI

Claude Code 是 Anthropic 官方推出的智能体 CLI 工具，也是整个工作流的核心引擎。

（1）安装（🪜）

打开终端（macOS）/CMD（Windows，管理员权限运行），输入以下命令全局安装：

npm install -g @anthropic-ai/claude-code

（2）检查

        安装完成后，务必重启终端，然后输入 claude --version。如果能正常输出版本号，说明安装成功。若提示 command not found，Windows 用户需手动将 %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/releases        Windows系统可选择以下安装包进行下载安装：

文件名	适用设备类型	安装方式	说明
CC-Switch-v3.17.0-Windows-arm64-Portable.zip	ARM64 架构设备（如 Surface Pro X、部分轻薄本）	免安装，解压即用	便携版，适合U盘携带或临时使用
CC-Switch-v3.17.0-Windows-arm64.msi	ARM64 架构设备	标准安装向导	会写入注册表，支持系统级卸载
CC-Switch-v3.17.0-Windows-arm64.msi.sig	ARM64 架构设备	签名文件	用于验证 MSI 安装包完整性，非安装程序
CC-Switch-v3.17.0-Windows-Portable.zip	x86_64 架构设备（主流Intel/AMD电脑）	免安装，解压即用	便携版，适合U盘携带或临时使用
CC-Switch-v3.17.0-Windows.msi	x86_64 架构设备	标准安装向导	会写入注册表，支持系统级卸载
CC-Switch-v3.17.0-Windows.msi.sig	x86_64 架构设备	签名文件	用于验证 MSI 安装包完整性，非安装程序

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