Claude_Code_保姆级安装指南

小码农_0527

1173人浏览 · 2026-03-18 09:55:36

小码农_0527 · 2026-03-18 09:55:36 发布

Claude Code 保姆级安装指南

原文链接：https://mp.weixin.qq.com/s/Pz6oM6gKKWaXNsNUPmC_Ow
更新时间：2026年3月13日
阅读时长：约17分钟

一、Claude Code 是什么？

1.1 概念理解

可以用一个比喻来理解 Claude 生态系统的三个层次：

概念	比喻	特点
Claude	运营商（中国移动/电信）	大模型产品，提供"通信能力"（逻辑思考、代码编写、自然语言理解）
网页版 Claude	公用电话	需要手动拨号（复制粘贴代码），操作繁琐
Claude Code	智能手机（终端设备）	官方定制终端，自带"传感器"，能直接读取文件、运行命令、提交 Git

1.2 Claude Code 的核心能力

✅ 自动扫描整个项目文件夹：无需手动投喂代码
✅ 直接运行测试并自动改错：写完代码直接在电脑上运行
✅ 操作终端：打包、部署、写 Commit 一条龙服务
✅ 文件系统操作：直接创建、修改、删除文件

1.3 与 OpenClaw 的区别

维度	Claude Code	OpenClaw
定位	超级程序员	超级生活助理
专注领域	全链路代码开发与工程化落地	通用 AI 智能助手，多场景自动化执行
模型支持	单一模型（Anthropic）	多模型支持
记忆能力	无原生长期记忆	持久记忆与多任务同时执行
结果输出	多以文件形式输出	可在聊天框交付或落地本地系统
特点	单任务快、token 消耗低、代码能力强	多渠道交互，适用场景更广

二、安装前的准备工作

2.1 网络环境准备

必须先解决网络问题（你懂我在说什么的），确保能够访问 Claude 官方服务。

2.2 终端工具准备

Windows 用户

检查是否已安装 Windows Terminal

打开 PowerShell，输入以下命令：

Get-Command wt -ErrorAction SilentlyContinue

如果有输出 → 已安装
没有输出 → 需要安装

安装 Windows Terminal

在开始菜单搜索 “Microsoft Store” 或 “Store”
搜索 “Windows Terminal”
点击 “获取” 进行安装

Mac 用户

直接使用系统自带的 “终端”（Terminal）即可。

三、Claude Code 安装方法

方法一：终端安装（推荐）

这是最简单直接的安装方式。

Mac 用户

打开"终端"
复制以下命令并回车：

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

Windows 用户

搜索 “PowerShell”
右键 → “以管理员身份打开”
复制以下命令并回车：

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

安装完成后，会显示提示信息：Claude Code installed successfully

方法二：Git 安装

如果方法一失败，可以尝试 Git 安装方式。

2.1 安装 Git

访问 Git 官网：https://git-scm.com/install/windows
选择适合你系统的版本：
- Standalone Installer（独立安装程序）：最常用，下载后是 .exe 文件，双击运行即可
- x64 版本：适用于 64 位 Intel 或 AMD 处理器（绝大多数用户选择此版本）
- ARM64 版本：仅适用于 ARM 架构处理器（如 Surface Pro X、骁龙处理器笔记本、M1/M2/M3 Mac 虚拟机中的 Windows）

2.2 使用 Git 安装 Claude Code

搜索并打开 “Windows Terminal”
输入以下命令并回车：

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

等待安装完成，会显示安装成功提示。

方法三：Node.js 安装

如果前两种方法都失败，可以尝试 Node.js 安装方式。

3.1 下载 Node.js

访问官网：https://nodejs.org/zh-cn/download
Windows 用户选择 .msi 版本（标准 Windows 安装包）

3.2 安装 Node.js

安装步骤：

双击下载的 .msi 文件
一路点击 “下一步”（Next）

关键注意事项：

⚠️ 安装路径：默认安装在 C:\Program Files\nodejs\，强烈建议保持默认路径，避免玄学报错
⚠️ 自定义设置：检查 “Add to PATH” 选项是否带有完整的硬盘图标（决定能否直接使用命令）
⚠️ 重启终端：安装前已打开的 PowerShell 或 CMD 必须关闭并重新打开，否则会提示"找不到 npm 命令"

3.3 验证 Node.js 安装

打开新的 PowerShell 窗口，分别输入以下命令：

node -v
npm -v

node -v 应显示类似 v24.14.0 的版本号
npm -v 应显示类似 11.9.0 的版本号

3.4 使用 npm 安装 Claude Code

在确保网络的前提下，复制以下命令到终端并回车：

npm install -g @anthropic-ai/claude-code --registry=<registry>

⚠️ 注意：<registry> 需要替换为实际使用的 npm 源地址

3.5 验证安装

输入以下命令验证是否安装成功：

claude --version

四、Claude 账号配置

4.1 账号问题说明

Claude 官方对中国账号限制较严，主要体现在：

IP 纯净度要求高
账号纯净度要求高
海外几家大模型中最严格之一

4.2 两种解决方案

方案	适用场景	优缺点
API 中转服务	追求 Claude 原生效果	绕过区域限制，解决付款问题，主流省心
模型平替方案	非程序员，日常需求简单	虽复杂问题处理不如 Claude，但日常需求基本够用

方案一：智谱 GLM 系列模型

智谱在编码能力方面讨论度很高，被视为 Claude Code 的热门平替方案。

步骤 1：注册智谱 API

访问智谱 API 官网：https://bigmodel.cn/usercenter/proj-mgmt/apikeys
注册账号
创建 API Key（这是你的"电表账号"）

步骤 2：安装智谱 API 工具

在终端会话中输入以下命令：

npx @bigmodel-ai/coding-tool-helper install

弹出是否继续时，输入 y 并回车
等待安装完成

步骤 3：配置 API Key

使用方向键选择语言（选择"中文"）
选择 GLM Coding Plan 套餐（选择"中国版"）
粘贴刚才创建的 API Key
配置成功后，重新打开新的终端窗口使配置生效

方案二：使用 CC Switch

CC Switch 是一个用于管理和切换 Claude Code 配置的工具，支持在不同模型之间快速切换。

步骤 1：安装 CC Switch

访问 GitHub Releases 页面：https://github.com/farion1231/cc-switch/releases/tag/v3.11.1
下载适合你系统的版本
按默认选项安装
打开后，顶部菜单栏如下所示

步骤 2：配置模型 API（以 DeepSeek 为例）

注册 DeepSeek 账号

访问 DeepSeek 官网：https://www.deepseek.com/
点击右侧 “API 开放平台”
点击左侧菜单 “API Keys”
点击 “创建 API Key”
如余额不足需充值（纯体验建议充值 10 元）

⚠️ 安全提示：API Key 创建后不要告诉任何人，它相当于一张不需要密码的银行卡。

为 CC Switch 添加 API

打开 CC Switch
点击右上角 “+” 号
在模型供应商中选择 “Deepseek”
向下滑动到 “API Key” 栏
粘贴刚才复制的 Key
点击右下角 "添加"按钮
配置完成

步骤 3：使用

重启 Claude，打开终端输入 claude，即可使用配置的模型。

五、Claude Code 常用命令速查

5.1 基础操作

命令选择方式：

使用 ↑ 和 ↓ 键选中命令
选中后按 Enter 执行
或直接输入对应序号，回车发送

5.2 常用命令汇总表

命令	作用	操作说明
`/clear`	清空所有历史上下文，节省 Token	输入 `/clear` 回车；适用场景：完成功能开发后切换新话题
`/compact`	总结压缩上下文，保留核心内容	输入 `/compact` 回车；技巧：按 Tab 键后可添加参数，如 `/compact 保留用户管理的内容`
`/config`	个性化设置	输入 `/config` 打开配置面板；关键设置：将 language 设置为中文，按 ESC 返回
`/context`	可视化查看 Token 使用情况	输入 `/context`；显示内容：黄色代表"技能"Token，紫色代表对话消息Token，列出 MCP 工具使用情况
`/copy`	一键复制最后回复	输入 `/copy`；特点：自动以 Markdown 格式复制到剪贴板
`/export`	导出整个对话	输入 `/export`；作用：导出当前会话到文件或剪贴板，方便查阅备份
`/hooks`	管理所有的 hook	输入 `/hooks`；说明：hook 是特定时间点执行的"回调动作"，可插入自定义脚本/代码
`/init`	初始化记忆文件	在项目目录下输入 `/init`；作用：创建 CLAUDE.md 记忆文件（项目"说明书"）；技巧：输入 `/init 使用中文` 生成中文项目概览
`/mcp`	查看和管理 MCP 工具	输入 `/mcp`；功能：查看已安装 MCP 工具，可禁用暂时不用的工具（如 Playright MCP）
`/memory`	编辑记忆文件	输入 `/memory`；作用：编辑记忆文件（Claude Code 的"专属规则库"）；用途：设置编程风格、代码规范等
`/model`	切换模型	输入 `/model` 回车；方法：用上下方向键选择模型（如 Sonnet 4.5 或 Haiku），回车确认
`/plan`	进入/查看规划模式	输入 `/plan`；作用：管理复杂项目开发步骤，查看已有计划
`/plugin`	管理插件	输入 `/plugin`；功能：发现、安装专属插件，解锁更多定制化功能
`/rename`	给当前对话重命名	输入 `/rename` 加 Tab，然后输入名字（如 `build-in commands`）；好处：方便以后查找
`/resume`	回到之前的某次对话	输入 `/resume`；功能：列出所有对话列表，选择想继续的对话无缝衔接
`/skills`	显示当前所有 skills	输入 `/skills`
`/status`	查看当前状态	输入 `/status`；显示内容：会话名、ID、工作目录、使用模型、记忆文件等
`/statusline`	配置状态栏	输入 `/statusline`；示例：输入 `/statusline 显示模型和剩余上下文比例`；显示：实时显示当前模型和剩余上下文比例（如 68%）
`/usage`	查看你的用量配额	输入 `/usage`；适用：Pro 订阅用户；显示：如"当前 5 小时用量已用 32%"、“本周用量已用 9%”

5.3 高频使用场景示例

场景 1：开始新项目

# 1. 进入项目目录
cd /path/to/your/project

# 2. 初始化项目记忆文件（中文）
/init 使用中文

# 3. 查看当前状态
/status

# 4. 开始使用
claude

场景 2：设置编程规范

# 打开记忆文件编辑
/memory

# 在文件中添加你的代码规范，例如：
"""
- 使用 TypeScript 类型注解
- 函数名使用驼峰命名
- 变量名使用蛇形命名
- 每个 PR 不超过 500 行代码
"""

场景 3：切换模型

# 打开模型切换界面
/model

# 使用方向键选择模型，回车确认

场景 4：查看 Token 使用情况

# 可视化查看 Token 使用
/context

# 查看 Pro 订阅用量
/usage

六、安装流程总结

用一个形象的比喻来总结整个安装流程：

步骤	比喻	实际操作
配置基站	从墙外迁一条网线	解决网络问题，配置代理环境
领用手机	下载安装 APP	执行安装脚本，安装 Claude Code
办卡激活	实名认证	运行 `claude` 命令，在网页登录 Anthropic 账号
配置资费	办理套餐	配置 API Key 或选择平替模型

七、常见问题排查

7.1 安装失败

如果安装过程中遇到问题：

截图保存错误信息
将安装背景和报错信息发送给 AI（豆包、KIMI 等）寻求帮助
尝试切换其他安装方法

7.2 网络问题

确保网络环境稳定、绿色
Claude Code 安装过程需要良好的网络连接

7.3 终端命令无效

Windows 用户确保使用管理员权限打开 PowerShell
安装 Node.js 后务必重启终端窗口

八、后续学习建议

从简单任务开始：先用 Claude Code 完成一些小功能，熟悉交互方式
善用记忆文件：通过 /memory 建立项目规范，提高代码一致性
探索 MCP 工具：通过 /mcp 发现和安装更多工具，扩展 Claude Code 能力
关注 Token 使用：通过 /context 和 /usage 监控使用情况，优化成本

附录：快速安装命令汇总

# Mac - 方法一（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# Windows - 方法一（推荐，管理员权限运行 PowerShell）
irm https://claude.ai/install.ps1 | iex

# Windows - 方法二（Git 安装）
# 1. 先安装 Git：https://git-scm.com/install/windows
# 2. 运行安装命令：
irm https://claude.ai/install.ps1 | iex

# Windows/Mac - 方法三（Node.js 安装）
# 1. 先安装 Node.js：https://nodejs.org/zh-cn/download
# 2. 验证安装：
node -v
npm -v
# 3. 运行安装命令：
npm install -g @anthropic-ai/claude-code --registry=<registry>
# 4. 验证安装：
claude --version

# 验证安装成功
claude