手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

# 小白也能学会！手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

## 一、前言

**Claude Code CLI** 是 Anthropic 官方推出的命令行编程助手工具。你可以在终端里直接跟 AI 对话，让它帮你写代码、改 Bug、解释项目结构，甚至执行 Git 操作和终端命令。简单说——**把你的终端变成 AI 结对编程搭档**。

本文面向**零基础或刚入门**的读者，全程图文式讲解，内容包括：

- 安装前的环境准备
- 在 macOS / Windows 上安装 Claude Code CLI
- 在国内网络下**避开官方登录**，接入 DeepSeek 等国产大模型 API
- 几个最常用的命令和技巧

---

## 二、安装前的准备工作

在正式开始安装之前，请先确保你的电脑满足以下条件。

### 2.1 环境要求

| 系统    | 要求                          |
| ------- | ----------------------------- |
| macOS   | macOS 11 (Big Sur) 或更高版本 |
| Windows | Windows 10 / 11，64 位        |
| Linux   | x86_64, glibc 2.27+           |

### 2.2 安装 Node.js（必须）

Claude Code CLI 基于 Node.js，所以你需要在电脑上安装 **Node.js 18 或更高版本**。

**安装步骤：**

1. 打开浏览器，访问 [https://nodejs.org](https://nodejs.org)
2. 下载 **LTS（长期支持）** 版本（左侧按钮，标记为 "LTS"）
3. 双击下载好的安装包
4. Windows：一路点击 "Next"；macOS：一路点击 "继续" → "安装"
5. 安装完成后，**重启终端**

**验证是否成功：**

打开终端（macOS 的"终端.app"，或 Windows 的"命令提示符 / PowerShell"），输入：

```bash
node --version
npm --version
```

如果能看到版本号（例如 `v18.20.0` 和 `10.5.0`），说明安装成功。

> 💡 `npm` 是 Node.js 自带的包管理器，后续安装 Claude Code CLI 要用到它，不需要单独安装。

### 2.3 网络环境说明（国内用户注意事项）

由于 npm 默认镜像源在国外，国内用户安装时可能遇到**下载慢**或**超时失败**的问题。推荐在安装前配置淘宝镜像源（加速 npm 包的下载）：

```bash
npm config set registry https://registry.npmmirror.com
```

配置后下载速度会显著提升，且只影响包下载，不影响后续使用。

### 2.4 Git（可选但推荐）

虽然不是强制要求，但 Claude Code 很多功能（查看代码变更、创建 PR 等）都依赖 Git。如果你还没有安装：

- **macOS：** 终端运行 `git --version`，如果未安装会自动弹出安装提示
- **Windows：** 访问 [https://git-scm.com](https://git-scm.com) 下载安装
- 安装完成后配置用户名和邮箱：
  ```bash
  git config --global user.name "你的名字"
  git config --global user.email "你的邮箱"
  ```

---

## 三、安装 Claude Code CLI

### 3.1 macOS 安装步骤

**使用 npm 安装（推荐，两种平台通用）：**

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

参数说明：`-g` 表示全局安装，安装后可以在任意目录下直接使用 `claude` 命令。

**备用方案：使用 Homebrew 安装（仅限 macOS）**

如果你已经安装了 Homebrew（macOS 的包管理器），也可以：

```bash
brew install claude-code
```

### 3.2 Windows 安装步骤

打开 PowerShell（建议**以管理员身份运行**），执行：

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

> ⚠️ 如果遇到类似 "无法加载文件...因为在此系统上禁止运行脚本" 的错误，先执行以下命令（允许本地运行脚本，安全无风险）：
>
> ```powershell
> Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
> ```
>
> 然后再次尝试上面的 npm 安装命令。

### 3.3 验证安装

安装完成后，在终端输入：

```bash
claude --version
```

如果能显示出版本号（例如 `0.3.0`），说明安装成功。

---

## 四、运行 Claude Code CLI

### 4.1 首次运行

在终端中直接输入：

```bash
claude
```

你会看到启动画面，然后**要求你登录 Anthropic 账号**。这是因为默认情况下，Claude Code CLI 使用的是 Anthropic 自家的 Claude API 服务。

### 4.2 国内用户面临的问题

由于以下原因，国内用户**无法直接使用**默认配置：

1. **Anthropic 官网被限制访问**，无法完成 OAuth 登录
2. **Claude API 接口**在国内无法直接访问
3. **API Key 获取困难**（需要海外手机号验证）

这意味着开箱即用不可行。下一节将教你如何绕过这些限制。

---

## 五、避开登录，接入 DeepSeek 或其他大模型 API

### 5.1 原理说明

Claude Code CLI 支持通过 `ANTHROPIC_BASE_URL` 环境变量**自定义 API 地址**。只要对接一个**兼容 OpenAI/Anthropic 接口格式**的 API 服务，就可以替换掉官方模型，不再需要 Anthropic 账号。

通俗理解：原本 Claude Code 默认找的是"Anthropic 家的 API"，我们把地址改成"DeepSeek 家的 API"，它就去 DeepSeek 那里请求 AI 能力了。

### 5.2 获取 DeepSeek API Key（免费注册）

1. 打开浏览器，访问 [https://platform.deepseek.com](https://platform.deepseek.com)
2. 点击右上角 "Sign Up" 注册账号（支持国内邮箱）
3. 登录后，进入左侧菜单 "API Keys"
4. 点击 "Create API Key"，输入名称（例如 `claude-code`），点击创建
5. **复制并保存好这个 Key**（关闭弹窗后就看不到了，请务必保存到本地）

> 💡 DeepSeek 可以先充值体验效果。

### 5.3 方式一：临时代理（推荐首次测试）

每次启动终端时，先设置环境变量再运行：

**macOS / Linux：**

```bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-你的DeepSeek API密钥"
claude
```

**Windows（PowerShell）：**

```powershell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY="sk-你的DeepSeek API密钥"
claude
```

如果终端关闭，下次需要重新设置。适合先**测试是否能用**。

### 5.4 方式二：配置文件持久化（推荐日常使用）

创建配置文件，配置一次永久生效。

**macOS / Linux：**

```bash
# 创建配置文件目录
mkdir -p ~/.claude

# 创建配置文件
cat > ~/.claude/settings.json << 'EOF'
{
  "apiBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-你的DeepSeek API密钥"
}
EOF
```

**Windows（PowerShell）：**

```powershell
# 创建配置文件目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 创建配置文件
@'
{
  "apiBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-你的DeepSeek API密钥"
}
'@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding utf8
```

配置好后，直接运行 `claude` 即可，不再需要每次手动设置环境变量。

### 5.5 验证配置是否生效

运行如下命令，检查是否报错：

```bash
claude --version
```

如果没有错误提示，说明配置文件加载成功。然后运行：

```bash
claude
```

进入交互模式后，问它："你是谁？"——如果它回答与 DeepSeek 相关，说明接入成功了。

### 5.6 其他可选模型

除了 DeepSeek，你也可以接入其他兼容 OpenAI 接口格式的服务，将上面配置中的 `apiBaseUrl` 和 `apiKey` 替换即可：

| 服务商             | API Base URL                                          | 说明                       |
| ------------------ | ----------------------------------------------------- | -------------------------- |
| DeepSeek           | `https://api.deepseek.com/v1`                       | 性价比高，速度快，推荐首选 |
| 阿里通义           | `https://dashscope.aliyuncs.com/compatible-mode/v1` | 需开通通义千问 API         |
| 智谱 GLM           | `https://open.bigmodel.cn/api/paas/v4`              | 需开通智谱开放平台         |
| Ollama（本地运行） | `http://localhost:11434/v1`                         | 完全本地运行，无需联网     |

> ⚠️ **重要提示：** Claude Code 原生针对 Claude 模型做了很多深度优化（Tool Use 机制、超长上下文窗口、系统提示词等）。切换到其他模型后，部分高级功能可能**不能完全正常工作**。目前社区反馈中，**DeepSeek 是兼容性最好的选择**，基本能覆盖日常代码编写和审查的需求。

---

## 六、常用命令与实战技巧

### 6.1 `claude` — 启动交互式对话

最基础的用法，进入对话界面。然后可以直接用自然语言提需求：

```
> 帮我写一个 Python 脚本，读取当前目录下所有 CSV 文件并合并为一个
```

Claude Code 会自动理解上下文，生成代码并执行。

### 6.2 `claude -p "你的问题"` — 单次问答模式

适合快速查询，不进入交互界面，执行完后直接退出终端：

```bash
claude -p "git 如何撤销最后一次 commit？"
```

该命令也可以配合管道使用，将其他命令的输出传给它处理：

```bash
cat main.py | claude -p "帮我 review 这段代码，指出潜在问题"
```

### 6.3 `claude -f 文件路径` — 处理指定文件

直接让 Claude Code 读取并处理某个文件，适合一键修复或分析：

```bash
claude -f index.js -p "给这个文件添加 TypeScript 类型注解"
```

### 6.4 `claude --model` — 指定模型

如果你在配置中同时对接了多个模型，可以用这个参数切换：

```bash
claude --model deepseek-chat
```

对于其他 API 服务，填入对应的模型名称（例如通义千问的 `qwen-plus`）。

### 6.5 `claude --resume` — 恢复上次会话

如果上次对话因意外中断（终端关闭、断网、电脑休眠等）而退出，可以用此命令恢复：

```bash
claude --resume
```

对话上下文和历史都不会丢失，非常实用。

### 6.6 `claude --help` — 查看所有命令和参数

记不清参数时随时查看：

```bash
claude --help
```

会列出所有可用的 flag（命令行参数）和使用示例。

### 6.7 交互模式下的实用快捷键

在 `claude` 交互模式下，可以像在 Shell 中使用快捷键：

| 快捷键          | 作用                |
| --------------- | ------------------- |
| `Ctrl + C`    | 取消当前输入 / 退出 |
| `↑` / `↓` | 浏览历史消息        |
| 输入 `/help`  | 查看交互模式帮助    |
| 输入 `/clear` | 清空当前会话上下文  |
| `Ctrl + L`    | 清屏                |

---

## 七、常见问题排查

### Q1：安装时提示 `EACCES: permission denied`

**原因：** macOS 对全局 npm 包的权限检查比较严格。

**解决：** 不要使用 `sudo`，而是配置 npm 的全局路径：

```bash
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
# 重新尝试安装
npm install -g @anthropic-ai/claude-code
```

### Q2：运行 `claude` 提示命令未找到

**原因：** npm 全局安装路径没有加到系统的 `PATH` 环境变量中。

**解决：** 向你的 Shell 配置文件中添加：

```bash
echo 'export PATH=$(npm bin -g):$PATH' >> ~/.zshrc
source ~/.zshrc
```

### Q3：运行后提示 `Request failed with status 401`（认证失败）

**原因：** API Key 无效或配置错误。

**解决：** 检查 `~/.claude/settings.json` 中的 `apiKey` 字段是否正确，注意不要有多余空格。

### Q4：运行后提示 `connect ETIMEDOUT`

**原因：** 无法连接到配置的 API 地址，可能是网络问题。

**解决：** 先在终端中用 `curl` 测试 API 地址是否可达：

```bash
curl -I https://api.deepseek.com/v1
```

如果返回非 200 状态码，说明该 API 服务在你当前的网络环境中不可用，请更换为其他可选服务商。

---

## 八、总结

回顾一下今天操作的全流程：

1. **准备工作**：安装 Node.js ≥ 18，验证 `node --version`
2. **安装**：一行命令 `npm install -g @anthropic-ai/claude-code`
3. **配置国内接入**：创建 `~/.claude/settings.json`，写入 DeepSeek 的 API 地址和密钥
4. **运行**：`claude` 启动交互式对话，`claude -p "问题"` 单次问答
5. **常用命令**：`--resume` 恢复会话、`--model` 切换模型、`--help` 查看帮助

Claude Code CLI 是一个非常强大的编程助手工具，尤其适合在终端中完成**代码生成、代码审查、项目探索、问题排查**等任务。配合 DeepSeek 等国产大模型 API，国内用户完全可以零门槛上手使用。

---

> 💡 **扩展阅读建议：**
>
> - 如果想进一步了解 Claude Code 的官方文档，可以访问 [https://docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)（需科学上网）
> - 如果想了解 DeepSeek 的更多模型能力，查阅 [DeepSeek 官方文档](https://platform.deepseek.com/docs)
> - 在终端中随时输入 `claude --help` 查看所有可用功能

# 小白也能学会！手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

## 一、前言

本文面向**零基础或刚入门**的读者，全程图文式讲解，内容包括：

- 安装前的环境准备
- 在 macOS / Windows 上安装 Claude Code CLI
- 在国内网络下**避开官方登录**，接入 DeepSeek 等国产大模型 API
- 几个最常用的命令和技巧

---

## 二、安装前的准备工作

在正式开始安装之前，请先确保你的电脑满足以下条件。

### 2.1 环境要求

### 2.2 安装 Node.js（必须）

Claude Code CLI 基于 Node.js，所以你需要在电脑上安装 **Node.js 18 或更高版本**。

**安装步骤：**

**验证是否成功：**

打开终端（macOS 的"终端.app"，或 Windows 的"命令提示符 / PowerShell"），输入：

```bash
node --version
npm --version
```

如果能看到版本号（例如 `v18.20.0` 和 `10.5.0`），说明安装成功。

> 💡 `npm` 是 Node.js 自带的包管理器，后续安装 Claude Code CLI 要用到它，不需要单独安装。

### 2.3 网络环境说明（国内用户注意事项）

由于 npm 默认镜像源在国外，国内用户安装时可能遇到**下载慢**或**超时失败**的问题。推荐在安装前配置淘宝镜像源（加速 npm 包的下载）：

```bash
npm config set registry https://registry.npmmirror.com
```

配置后下载速度会显著提升，且只影响包下载，不影响后续使用。

### 2.4 Git（可选但推荐）

虽然不是强制要求，但 Claude Code 很多功能（查看代码变更、创建 PR 等）都依赖 Git。如果你还没有安装：

---

## 三、安装 Claude Code CLI

### 3.1 macOS 安装步骤

**使用 npm 安装（推荐，两种平台通用）：**

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

参数说明：`-g` 表示全局安装，安装后可以在任意目录下直接使用 `claude` 命令。

**备用方案：使用 Homebrew 安装（仅限 macOS）**

如果你已经安装了 Homebrew（macOS 的包管理器），也可以：

```bash
brew install claude-code
```

### 3.2 Windows 安装步骤

打开 PowerShell（建议**以管理员身份运行**），执行：

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

### 3.3 验证安装

安装完成后，在终端输入：

```bash
claude --version
```

如果能显示出版本号（例如 `0.3.0`），说明安装成功。

---

## 四、运行 Claude Code CLI

### 4.1 首次运行

在终端中直接输入：

```bash
claude
```

你会看到启动画面，然后**要求你登录 Anthropic 账号**。这是因为默认情况下，Claude Code CLI 使用的是 Anthropic 自家的 Claude API 服务。

### 4.2 国内用户面临的问题

由于以下原因，国内用户**无法直接使用**默认配置：

1. **Anthropic 官网被限制访问**，无法完成 OAuth 登录
2. **Claude API 接口**在国内无法直接访问
3. **API Key 获取困难**（需要海外手机号验证）

这意味着开箱即用不可行。下一节将教你如何绕过这些限制。

---

## 五、避开登录，接入 DeepSeek 或其他大模型 API

### 5.1 原理说明

通俗理解：原本 Claude Code 默认找的是"Anthropic 家的 API"，我们把地址改成"DeepSeek 家的 API"，它就去 DeepSeek 那里请求 AI 能力了。

### 5.2 获取 DeepSeek API Key（免费注册）

> 💡 DeepSeek 可以先充值体验效果。

### 5.3 方式一：临时代理（推荐首次测试）

每次启动终端时，先设置环境变量再运行：

**macOS / Linux：**

```bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-你的DeepSeek API密钥"
claude
```

**Windows（PowerShell）：**

```powershell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY="sk-你的DeepSeek API密钥"
claude
```

如果终端关闭，下次需要重新设置。适合先**测试是否能用**。

### 5.4 方式二：配置文件持久化（推荐日常使用）

创建配置文件，配置一次永久生效。

**macOS / Linux：**

```bash
# 创建配置文件目录
mkdir -p ~/.claude

# 创建配置文件
cat > ~/.claude/settings.json << 'EOF'
{
  "apiBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-你的DeepSeek API密钥"
}
EOF
```

**Windows（PowerShell）：**

```powershell
# 创建配置文件目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

配置好后，直接运行 `claude` 即可，不再需要每次手动设置环境变量。

### 5.5 验证配置是否生效

运行如下命令，检查是否报错：

```bash
claude --version
```

如果没有错误提示，说明配置文件加载成功。然后运行：

```bash
claude
```

进入交互模式后，问它："你是谁？"——如果它回答与 DeepSeek 相关，说明接入成功了。

### 5.6 其他可选模型

除了 DeepSeek，你也可以接入其他兼容 OpenAI 接口格式的服务，将上面配置中的 `apiBaseUrl` 和 `apiKey` 替换即可：

---

## 六、常用命令与实战技巧

### 6.1 `claude` — 启动交互式对话

最基础的用法，进入对话界面。然后可以直接用自然语言提需求：

```
> 帮我写一个 Python 脚本，读取当前目录下所有 CSV 文件并合并为一个
```

Claude Code 会自动理解上下文，生成代码并执行。

### 6.2 `claude -p "你的问题"` — 单次问答模式

适合快速查询，不进入交互界面，执行完后直接退出终端：

```bash
claude -p "git 如何撤销最后一次 commit？"
```

该命令也可以配合管道使用，将其他命令的输出传给它处理：

```bash
cat main.py | claude -p "帮我 review 这段代码，指出潜在问题"
```

### 6.3 `claude -f 文件路径` — 处理指定文件

直接让 Claude Code 读取并处理某个文件，适合一键修复或分析：

```bash
claude -f index.js -p "给这个文件添加 TypeScript 类型注解"
```

### 6.4 `claude --model` — 指定模型

如果你在配置中同时对接了多个模型，可以用这个参数切换：

```bash
claude --model deepseek-chat
```

对于其他 API 服务，填入对应的模型名称（例如通义千问的 `qwen-plus`）。

### 6.5 `claude --resume` — 恢复上次会话

如果上次对话因意外中断（终端关闭、断网、电脑休眠等）而退出，可以用此命令恢复：

```bash
claude --resume
```

对话上下文和历史都不会丢失，非常实用。

### 6.6 `claude --help` — 查看所有命令和参数

记不清参数时随时查看：

```bash
claude --help
```

会列出所有可用的 flag（命令行参数）和使用示例。

### 6.7 交互模式下的实用快捷键

在 `claude` 交互模式下，可以像在 Shell 中使用快捷键：

---

## 七、常见问题排查

### Q1：安装时提示 `EACCES: permission denied`

**原因：** macOS 对全局 npm 包的权限检查比较严格。

**解决：** 不要使用 `sudo`，而是配置 npm 的全局路径：

```bash
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
# 重新尝试安装
npm install -g @anthropic-ai/claude-code
```

### Q2：运行 `claude` 提示命令未找到

**原因：** npm 全局安装路径没有加到系统的 `PATH` 环境变量中。

**解决：** 向你的 Shell 配置文件中添加：

```bash
echo 'export PATH=$(npm bin -g):$PATH' >> ~/.zshrc
source ~/.zshrc
```

### Q3：运行后提示 `Request failed with status 401`（认证失败）

**原因：** API Key 无效或配置错误。

**解决：** 检查 `~/.claude/settings.json` 中的 `apiKey` 字段是否正确，注意不要有多余空格。

### Q4：运行后提示 `connect ETIMEDOUT`

**原因：** 无法连接到配置的 API 地址，可能是网络问题。

**解决：** 先在终端中用 `curl` 测试 API 地址是否可达：

```bash
curl -I https://api.deepseek.com/v1
```

如果返回非 200 状态码，说明该 API 服务在你当前的网络环境中不可用，请更换为其他可选服务商。

---

## 八、总结

回顾一下今天操作的全流程：

---

最后修改：2026 年 05 月 16 日

都滑到这里了，不点赞再走！？

手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Java基础之JDK的安装

迄今为止，程序员最佳输入法非Rime莫属

C#-WinForms实现手写板

数据库访问技术ADO.NET

开启Visual Studio Code编写jQuery语法提示

基于C#和MailKit构建企业级邮件客户端的实战指南

Vue生命周期详解-面试题

T-SQL编程之数据的查询基础

来自唐能彪同学的项目总结

来自胡福厚同学的项目总结

手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

手把手教你安装 Claude Code CLI，接入 DeepSeek 等国产大模型

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款