Claude Code国内安装：2026最新保姆教程（附cc-switch配置）

前言

Claude Code是我目前最推荐的AI编程工具，没有之一。它可能不是最简单的，但绝对是上限最高的。一旦跑通安装、接上模型、定好规范，你会发现很多原本需要几小时的工作，现在几分钟就能搞定。这套方案的核心优势就三个字：可控性。你不用依赖任何不稳定服务，所有组件都在自己手里。模型效果不好？换一个。框架更新了？自己决定升不升。这才是AI时代开发者该有的姿势——不是被动等喂饭，而是主动搭建自己的生产力基础设施。

一、Claude Code是什么？

Claude Code是Anthropic公司推出的AI编程工具，可以帮助你：

• 编写和编辑代码
• 创建文件和项目
• 运行命令和程序
• 自动修复错误
• 执行复杂的开发任务

二、安装Claude Code

Windows安装

在PowerShell中执行：

irm https://claude.ai/install.ps1 | iex

MacOS/Linux安装

curl -fsSL https://claude.ai/install.sh | bash

安装路径说明

• Windows程序路径：C:\Users\user\.local\bin\claude.exe
• 配置文件路径：C:\Users\user\.claude
• 默认配置文件settings.json内容：

{
  "autoUpdatesChannel": "latest"
}

验证安装

执行以下命令验证安装是否成功：

claude --version

如果遇到”无法识别claude命令”的错误，需要将程序路径添加到系统环境变量。

三、配置国内AI模型

为什么要配置cc-switch？

Claude Code默认使用的是Anthropic的官方模型，但国内用户直接访问会有网络问题。通过cc-switch工具，可以轻松切换到国内模型（如DeepSeek），实现稳定快速的AI编程体验。

安装cc-switch

1. 访问 cc-switch项目地址：https://github.com/farion1231/cc-switch
2. 选择对应操作系统的安装包进行安装
3. 安装完成后打开cc-switch

cc-switch支持的模型

cc-switch不仅支持Claude，还支持：

• Codex（OpenAI）
• Gemini（Google）
• OpenCode
• OpenClaw（非常流行的开源方案）

配置DeepSeek模型

1. 打开cc-switch
2. 点击右上角加号按钮添加新模型
3. 填写API Key（以DeepSeek为例）
4. 保存配置

手动配置settings.json

如果你不想安装cc-switch，也可以直接修改配置文件：

{
  "autoUpdatesChannel": "latest",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V3.2",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V3.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V3.2",
    "ANTHROPIC_MODEL": "DeepSeek-V3.2"
  }
}

配置保存后，Claude Code会自动使用DeepSeek模型，实时生效，无需重启。

四、快速入门示例

下面我们用一个简单的例子——创建一个贪吃蛇游戏——来演示Claude Code的使用流程。

1. 描述需求

在终端输入你的需求，Claude Code会自动开始编写代码。

2. 保存文件

代码编写完成后，Claude Code会询问是否创建文件。

3. 安装依赖

例如需要pygame模块时，可以让Claude Code自动安装：

请帮我安装pygame模块并运行程序

4. 运行程序

Claude Code会自动处理依赖安装并运行程序。

5. 查看结果

程序运行后，Claude Code会给出详细的说明和总结。

五、常见问题解决

1. Unable to connect to Anthropic services

如果遇到这个错误，说明当前网络无法直接访问Anthropic服务。解决方案：

• 配置代理
• 使用国内模型（如DeepSeek、阿里通义）
• 使用cc-switch切换到可用的模型

2. 命令行不可用

检查是否已将claude可执行文件路径添加到系统环境变量：

• Windows：C:\Users\user\.local\bin
• Linux/Mac：~/.local/bin

3. Git未安装

如果安装过程中提示需要Git，请在官网下载安装Git后再重试。

六、总结

Claude Code是一个强大的AI编程工具，通过cc-switch或手动配置，国内用户完全可以流畅使用。选择国内模型不仅解决了网络问题，还能享受更快的响应速度和更低的成本。

希望这篇保姆教程能帮助你顺利上车，做出你自己的作品！