# claude-code-deepseek-setup

**Repository Path**: cctccodeli/claude-code-deepseek-setup

## Basic Information

- **Project Name**: claude-code-deepseek-setup
- **Description**: No description available
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code 一键配置（中国内地优化版）

> Claude Code + 国产大模型，纯国内环境，无需代理/VPN，零门槛。

---

## 📥 开始使用

### 🍎 macOS / Linux

打开终端，粘贴运行：

```bash
curl -fsSL https://gitee.com/cctccodeli/claude-code-deepseek-setup/raw/main/setup-claude-code.sh | bash
```

> 脚本会自动安装 Node.js、Git（如缺少），然后通过腾讯云镜像下载 Claude Code，全程国内直连。

---

### 🪟 Windows

Windows 用户需要 **3 步**：

**第 1 步：安装 PowerShell 7+**（任选一种）

| 方式 | 命令/链接 |
|------|-----------|
| winget（推荐，Win10/11自带） | `winget install --id Microsoft.PowerShell --source winget` |
| Microsoft Store | 搜索 "PowerShell" → 安装 |
| 手动下载 MSI | [GitHub Releases](https://github.com/PowerShell/PowerShell/releases) |

> ⚠️ Windows 自带的 PowerShell 5.1 版本太旧，必须先升级到 7+。

**第 2 步：下载脚本**

👉 **[点击下载 setup-claude-code.ps1](https://gitee.com/cctccodeli/claude-code-deepseek-setup/raw/main/setup-claude-code.ps1)**（右键另存为）

**第 3 步：运行脚本**

右键下载的 `.ps1` 文件 → **使用 PowerShell 7 运行**，或打开 PowerShell 7 终端执行：

```powershell
.\setup-claude-code.ps1
```

> 脚本会自动安装 Node.js、Git，然后通过腾讯云镜像下载 Claude Code，全程国内直连。

---

## 🔑 前置准备：API Key（任选一家注册）

| 供应商 | 模型 | 注册地址 | 实名 | 推荐 |
|--------|------|----------|------|------|
| **DeepSeek** | V4 Pro (1.6T) | [platform.deepseek.com](https://platform.deepseek.com) | 需要 | ★ 最推荐 |
| **Kimi** | K2.5 (1T) | [platform.moonshot.cn](https://platform.moonshot.cn) | 不需要 | 注册最简便 |
| **MiniMax** | M2.7 | [platform.minimaxi.com](https://platform.minimaxi.com) | 需要 | |
| 小米 MiMo | V2.5-Pro (1T) | [platform.xiaomimimo.com](https://platform.xiaomimimo.com) | 需要 | 需本地代理 |
| 商汤 SenseNova | Coder | [platform.sensenova.cn](https://platform.sensenova.cn) | 需要 | 需本地代理 |

> 脚本运行时会引导你选择供应商并填入 Key。**不知道选什么就选 DeepSeek。**

---

## 🖥️ VSCode 集成（可选）

脚本配置完成后，再装 VSCode 即可在编辑器里使用 Claude Code。

**下载 VSCode：**
- 国内镜像（推荐，直连）：[vscode.cdn.azure.cn](https://vscode.cdn.azure.cn)
- 官方网站：[code.visualstudio.com](https://code.visualstudio.com)

**安装 Claude Code 扩展：**

1. 打开 VSCode，点击左侧 **扩展图标**（或按 `Ctrl+Shift+X` / `Cmd+Shift+X`）
2. 搜索 **Claude Code**
3. 点击 **Install** 安装
4. 弹出提示时点击 **Trust（信任）**
5. 点击左侧边栏出现的 **Claude Code 图标**（菊花状图标）即可启动

> 扩展会自动读取 `~/.claude/settings.json`，无需重复配置。

---

## ⚙️ 核心原理

| 组件 | 方案 | 国内可用 |
|------|------|----------|
| **Claude Code 二进制** | 腾讯云 npm 镜像 (`mirrors.cloud.tencent.com/npm/`) | ✅ 直连 |
| **Node.js** | 淘宝 npm 镜像 (`npmmirror.com/mirrors/node/`) | ✅ 直连 |
| **主模型 API** | DeepSeek / Kimi / MiniMax Anthropic 兼容接口 | ✅ 直连 |
| **识图** | 小米MiMo / MiniMax / Kimi / 商汤 | ✅ 直连 |

**为什么用腾讯云 npm 镜像？**

Claude Code 自 v2.1.113 起是原生二进制（~245MB），托管在 Google Cloud Storage（被墙）。腾讯云镜像完整同步了所有平台的二进制包，是目前唯一可行的国内下载渠道。

---

## 📋 后续使用

```bash
# 终端启动
claude

# 更新到最新版
npm update -g @anthropic-ai/claude-code --registry=https://mirrors.cloud.tencent.com/npm/
```

### 切换模型供应商

编辑 `~/.claude/settings.json`，修改 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 即可。

---

## 🔗 镜像地址

- **Gitee（国内推荐）：** [gitee.com/cctccodeli/claude-code-deepseek-setup](https://gitee.com/cctccodeli/claude-code-deepseek-setup)
- **GitHub：** [github.com/cctccodeli-prog/claude-code-deepseek-setup](https://github.com/cctccodeli-prog/claude-code-deepseek-setup)