Claude Code：国内接入与第一项任务

用 CC Switch 添加 DeepSeek 供应商，切换 Claude Code 的 API 并运行练习。

这篇用 CC Switch 给 Claude Code 配置 DeepSeek API，再让它读写一个练习文件。准备好 Claude Code、CC Switch 和自己的 API Key；安装部分以 Windows 为例。

1. 安装

国内读者可以先用 npm 镜像。准备 Node.js 22 或以上，重新打开 PowerShell：

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

终端应显示版本号。PowerShell 拦截 npm.ps1 时，把命令开头换成 npm.cmd；找不到 claude 时先重新打开终端，再检查 PATH。

官方高级安装说明仍支持 npm 安装。它通过平台可选依赖安装原生程序；--include=optional 明确保留这些依赖，不要对这条命令添加 --ignore-scripts。报原生程序缺失时，检查对应系统、架构的平台包是否同步完整。

这条 --registry 只对本次命令生效，不修改 npm 全局配置。镜像可能有同步延迟；遇到 ETARGET，先核对包名和版本，官方源可达时把地址换成 https://registry.npmjs.org 重试。镜像不代理 GitHub、官方安装脚本或模型 API，也不代装 Node.js、Git；证书报错时保留 SSL 校验，检查网络和系统证书。

官方安装器备用

已有 WinGet 时可选下面的方式，仍需安装来源可达；选择一种方式即可：

winget install Anthropic.ClaudeCode
claude --version

Windows Cmd 的官方安装器（不是 PowerShell 命令）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS 已有 Homebrew 时：

brew install --cask claude-code
claude --version

Linux / WSL 可使用上面的 npm 路线，或官方安装页的对应安装器。Claude Code 可以在 Windows 原生运行，Git for Windows 为可选；WSL 用户把后续配置也放在 WSL 环境中，两种环境的沙箱能力有区别。npm 镜像不会改善 WinGet、Homebrew 或官方脚本的下载连接。

2. 准备 API Key

还没有 API Key 时，先按API 与配置的完整申请流程准备；本例使用 DeepSeek 平台的 Key，其他套餐请看对应服务商的专门说明。密钥只在自己的电脑输入，保存配置时避开截图和 Git 提交。

3. 用 CC Switch 配置 DeepSeek

先按CC Switch 配置教程完成下载、备份、选择应用、添加供应商、填写 Key、启用和切回，再确认下面的 Claude Code 特有差异。

Claude Code 与运行环境

选择 Claude Code，不是 Claude Desktop。两个面板的接入方式不同。WSL 用户还需确认 CC Switch 管理的是实际运行 Claude Code 的那套配置目录，不默认认为 Windows 配置会自动同步到 WSL。

DeepSeek 提供兼容接入方法。Anthropic 官方说明不支持将 Claude Code 经网关路由到非 Claude 模型；使用前确认相关服务的账号、地区和使用要求。

配置备份

需要备份、保留旧供应商卡片或切回时，按CC Switch 配置教程操作。备份可能含密钥，只保存在自己的电脑。

4. 简短验证

启用供应商后，在不含隐私的练习目录运行 claude，新开会话后只读检查 README，确认回答引用了文件且没有写入。完整的读取、创建、检查和定向修改流程见第一项任务。

5. 常见问题

现象	检查
仍连到旧服务	确认启用的是 Claude Code 面板的卡片，再检查旧终端变量和项目配置
Windows / WSL 配置不一致	确认 CC Switch 管理的是实际运行环境的配置目录，再在该环境重新开终端

401、额度、限流和通用超时按API 与配置的排错表检查。

恢复原来的配置

需要恢复原配置时，按CC Switch 配置教程比较备份并切回。切回后新开 Claude Code 会话，并在 Windows / WSL 的实际运行环境中确认配置；已创建的文件和产生的费用分别处理。

继续第一项任务或Claude Code Skills与MCP实践。

参考资料

资料核对：2026-09-15；镜像包元数据已查询，安装、命令和 API 尚未实机测试。

Claude Code：国内接入与第一项任务

本页目录