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

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，凭借强大的上下文理解和代码修改能力，被无数开发者誉为”最强AI编程工具”。但国内用户在安装和使用过程中，常常被网络代理、API 配置、模型切换等问题困扰。

本文将手把手教你从零完成 Claude Code 的国内安装，并使用 cc-switch 工具实现一键切换 API 源和模型，让你彻底告别配置折腾，专注写代码。

一、前置准备

在开始之前，请确保你的电脑满足以下条件：

Node.js 18+：Claude Code 的运行依赖
操作系统：macOS / Linux / Windows（Windows 建议使用 WSL2）
网络环境：能正常访问国内互联网即可（无需翻墙）

安装 Node.js（如已有可跳过）

# macOS (Homebrew)
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node -v   # v20.x.x
npm -v    # 10.x.x

二、安装 Claude Code

方式一：npm 全局安装（推荐）

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

方式二：使用国内镜像加速

如果 npm 下载较慢，可使用淘宝镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装

claude --version

如果显示版本号，说明安装成功。

三、安装 cc-switch

cc-switch 是一款专为 Claude Code 设计的 API 供应商切换工具，核心功能是：

图形化管理多个 API 供应商配置
一键切换不同的模型和 API 源
自动完成协议转换（Anthropic ↔ OpenAI 格式）
智能路由和灾备切换

下载安装

访问 cc-switch 的 GitHub Releases 页面下载对应平台的安装包：

macOS：下载 .dmg 文件，拖入 Applications
Windows：下载 .msi 文件，双击安装
Linux：下载 .AppImage 或 .deb 文件

GitHub 地址：https://github.com/farion1231/cc-switch/releases

也可以通过 Homebrew 安装（macOS）：

brew install --cask cc-switch

四、配置 API 供应商

cc-switch 支持两种使用方式：官方 Claude API 中转和国产大模型接入。下面分别介绍。

方案A：使用 Claude API 中转（推荐新手）

这种方式让你无需翻墙即可使用原版 Claude 模型。

Step 1：获取 API Key

注册一个 Claude API 中转服务（如 LinoAPI 等），获取 sk- 开头的 API Key。新用户通常有免费体验额度。

Step 2：在 cc-switch 中添加供应商

打开 cc-switch 客户端
点击右上角橘黄色 “+” 按钮
填写配置信息：
- 供应商名称：自定义（如”我的中转”）
- API Key：粘贴 sk- 开头的密钥
- 请求地址：填入中转服务的 Base URL（注意末尾不要带 /）
展开”高级选项”，配置模型映射：
- 主模型：claude-sonnet-4-6
- 推理模型：claude-sonnet-4-6-thinking
- Haiku 模型：claude-haiku-4-5-20251001
点击”保存”

Step 3：一键激活

回到 cc-switch 主界面，点击供应商卡片右侧的”终端”图标，即可激活配置。

方案B：接入国产大模型（低成本方案）

这种方式将 Claude Code 的请求转发至国产大模型，成本更低、网络更稳定。

推荐的国产模型供应商：

供应商	免费额度	特点	注册地址
Kimi（月之暗面）	15元	长文本能力强，代码能力优秀	platform.moonshot.cn
硅基流动	16元	模型多、响应快，适配Agent场景	cloud.siliconflow.cn
DeepSeek	有免费额度	性价比极高，API价格极低	platform.deepseek.com
通义千问	有免费额度	阿里出品，中文能力强	dashscope.aliyun.com

配置步骤（以硅基流动为例）：

在硅基流动官网注册并完成实名认证，获取 API Key
打开 cc-switch，点击”+”添加供应商
选择”SiliconFlow”预设模板
填入 API Key 和模型名称（如 Pro/deepseek-ai/DeepSeek-V3）
保存并激活

五、解决常见问题

问题1：400 报错 “thinking type should be enabled or disabled”

原因：新版 Claude Code（v2.1.97+）默认发送 thinking:{type:"adaptive"} 参数，部分第三方 API 不支持。

解决：在 cc-switch 中编辑通用配置，添加以下内容：

{
  "env": {
    "claude_code_disable_adaptive_thinking": "1"
  }
}

或者直接编辑 Claude Code 配置文件 ~/.claude/settings.json：

{
  "env": {
    "claude_code_disable_adaptive_thinking": "1"
  }
}

问题2：401 Unauthorized

原因：API Key 未正确映射或格式校验失败。

解决：检查 cc-switch 中的 API Key 是否完整复制，确保没有多余空格或换行。

问题3：终端频繁断连 / Timeout

原因：网关超时设置过短或网络波动。

解决：在 cc-switch 配置中调高超时时间（建议 120s），开启 keep_alive 连接池。

问题4：WSL2 中代理不生效

原因：WSL2 有独立的虚拟网卡，宿主机的代理不会自动继承。

解决：在 WSL2 中手动设置代理环境变量：

# 获取 Windows 宿主机 IP
WIN_IP=$(cat /etc/resolv.conf | grep nameserver | awk '"'"'{{print $2}}'"'"')

# 设置代理（根据你的代理端口调整）
export http_proxy="http://${WIN_IP}:7890"
export https_proxy="http://${WIN_IP}:7890"

# 验证
curl -I https://www.google.com

问题5：代码块格式错乱

原因：国产模型未完全识别 Claude Code 的标记语法。

解决：在 cc-switch 的 system_prompt_suffix 中强化格式约束，或切换至 deepseek-coder 等代码专项模型。

六、进阶优化技巧

6.1 Prompt 适配

在 cc-switch 中开启 prompt_inject 功能，追加系统提示词规则，可大幅提升代码生成准确率：

system_prompt_suffix: |
  - 始终使用中文注释
  - 优先输出可运行的完整代码块
  - 遇到文件修改时，严格遵循 diff 格式输出
  - 不输出与代码无关的解释性文字

6.2 流式响应优化

部分国内网关默认关闭 SSE 长连接。在 cc-switch 配置中启用：

streaming: true
chunk_buffer: 4096

6.3 上下文窗口管理

国产模型对超长上下文的处理策略不同，建议限制上下文长度：

# ~/.claude/settings.json
{
  "max_context_tokens": 8192
}

6.4 多供应商智能路由

cc-switch 支持配置多个供应商并设置路由规则。你可以同时配置 Claude 中转 + 国产模型，根据任务类型自动选择：

复杂架构设计 → Claude Sonnet（中转）
日常代码编写 → DeepSeek V3（国产）
长文本分析 → Kimi K2.5（国产）

七、Claude Code 常用命令速查

命令	功能
`claude`	启动交互式 Claude Code
`claude "你的问题"`	一次性提问
`claude auth login`	登录 Anthropic 账号
`claude auth login --manual`	手动模式登录
`claude config`	查看/修改配置
`claude /buddy`	召唤你的赛博伙伴
`claude --help`	查看帮助

八、总结

通过 cc-switch，国内开发者可以零门槛使用 Claude Code：

装工具：安装 Claude Code + cc-switch
备 API Key：选择中转服务或国产模型
填配置：在 cc-switch 中填入 API Key 和请求地址
一键激活：点击激活，开始编码

整个过程无需翻墙、无需折腾命令行配置，真正做到了”开箱即用”。无论你是选择原版 Claude 模型还是国产大模型，cc-switch 都能让你的 AI 编程体验丝滑顺畅。

打开终端，输入 claude，开始你的 AI 编程之旅吧！

无矩AI

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

一、前置准备

安装 Node.js（如已有可跳过）

二、安装 Claude Code

方式一：npm 全局安装（推荐）

方式二：使用国内镜像加速

验证安装

三、安装 cc-switch

下载安装

四、配置 API 供应商

方案A：使用 Claude API 中转（推荐新手）

方案B：接入国产大模型（低成本方案）

五、解决常见问题

问题1：400 报错 “thinking type should be enabled or disabled”

问题2：401 Unauthorized

问题3：终端频繁断连 / Timeout

问题4：WSL2 中代理不生效

问题5：代码块格式错乱

六、进阶优化技巧

6.1 Prompt 适配

6.2 流式响应优化

6.3 上下文窗口管理

6.4 多供应商智能路由

七、Claude Code 常用命令速查

八、总结

作者: ncomer

发表回复取消回复

联系我们

微信扫一扫关注我们

一、前置准备

安装 Node.js（如已有可跳过）

二、安装 Claude Code

方式一：npm 全局安装（推荐）

方式二：使用国内镜像加速

验证安装

三、安装 cc-switch

下载安装

四、配置 API 供应商

方案A：使用 Claude API 中转（推荐新手）

方案B：接入国产大模型（低成本方案）

五、解决常见问题

问题1：400 报错 “thinking type should be enabled or disabled”

问题2：401 Unauthorized

问题3：终端频繁断连 / Timeout

问题4：WSL2 中代理不生效

问题5：代码块格式错乱

六、进阶优化技巧

6.1 Prompt 适配

6.2 流式响应优化

6.3 上下文窗口管理

6.4 多供应商智能路由

七、Claude Code 常用命令速查

八、总结

给这篇文章的作者打赏

作者: ncomer

相关文章

国内AI助手横向测评：WorkBuddy、Trae Solo、DeepSeek TUI，谁才是你的最佳搭档？

OpenAI Codex CLI 常用命令大全：从入门到进阶速查手册

DeepSeek TUI全面解析：GitHub爆火的终端AI编程神器

火山引擎创作Agent功能落地的六大实用场景

手把手教你使用Trae Solo：AI驱动的下一代开发体验

手把手教你用AI做电商详情页

发表回复 取消回复

联系我们

微信扫一扫关注我们

发表回复取消回复