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

  1. 在开始菜单搜索 “Microsoft Store” 或 “Store”
  2. 搜索 “Windows Terminal”
  3. 点击 “获取” 进行安装
Mac 用户

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

三、Claude Code 安装方法

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

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

Mac 用户
  1. 打开"终端"
  2. 复制以下命令并回车：
curl -fsSL https://claude.ai/install.sh | bash
Windows 用户
  1. 搜索 “PowerShell”
  2. 右键 → “以管理员身份打开”
  3. 复制以下命令并回车：
irm https://claude.ai/install.ps1 | iex

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

方法二：Git 安装

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

2.1 安装 Git
  1. 访问 Git 官网：https://git-scm.com/install/windows
  2. 选择适合你系统的版本：
    • Standalone Installer（独立安装程序）：最常用，下载后是 .exe 文件，双击运行即可
    • x64 版本：适用于 64 位 Intel 或 AMD 处理器（绝大多数用户选择此版本）
    • ARM64 版本：仅适用于 ARM 架构处理器（如 Surface Pro X、骁龙处理器笔记本、M1/M2/M3 Mac 虚拟机中的 Windows）
2.2 使用 Git 安装 Claude Code
  1. 搜索并打开 “Windows Terminal”
  2. 输入以下命令并回车：
irm https://claude.ai/install.ps1 | iex
  1. 等待安装完成，会显示安装成功提示。

方法三：Node.js 安装

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

3.1 下载 Node.js
  1. 访问官网：https://nodejs.org/zh-cn/download
  2. Windows 用户选择 .msi 版本（标准 Windows 安装包）
3.2 安装 Node.js

安装步骤：

  1. 双击下载的 .msi 文件
  2. 一路点击 “下一步”（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
  1. 访问智谱 API 官网：https://bigmodel.cn/usercenter/proj-mgmt/apikeys
  2. 注册账号
  3. 创建 API Key（这是你的"电表账号"）
步骤 2：安装智谱 API 工具

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

npx @bigmodel-ai/coding-tool-helper install
  • 弹出是否继续时，输入 y 并回车
  • 等待安装完成
步骤 3：配置 API Key
  1. 使用方向键选择语言（选择"中文"）
  2. 选择 GLM Coding Plan 套餐（选择"中国版"）
  3. 粘贴刚才创建的 API Key
  4. 配置成功后，重新打开新的终端窗口使配置生效

方案二：使用 CC Switch

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

步骤 1：安装 CC Switch
  1. 访问 GitHub Releases 页面：https://github.com/farion1231/cc-switch/releases/tag/v3.11.1
  2. 下载适合你系统的版本
  3. 按默认选项安装
  4. 打开后，顶部菜单栏如下所示
步骤 2：配置模型 API（以 DeepSeek 为例）

注册 DeepSeek 账号

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

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

为 CC Switch 添加 API

  1. 打开 CC Switch
  2. 点击右上角 “+” 号
  3. 在模型供应商中选择 “Deepseek”
  4. 向下滑动到 “API Key” 栏
  5. 粘贴刚才复制的 Key
  6. 点击右下角 "添加"按钮
  7. 配置完成
步骤 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 安装失败

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

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

7.2 网络问题

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

7.3 终端命令无效

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

八、后续学习建议

  1. 从简单任务开始：先用 Claude Code 完成一些小功能，熟悉交互方式
  2. 善用记忆文件：通过 /memory 建立项目规范，提高代码一致性
  3. 探索 MCP 工具：通过 /mcp 发现和安装更多工具，扩展 Claude Code 能力
  4. 关注 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

最后提示：如果在安装或使用过程中遇到任何问题，都可以随时将错误信息截图发给 AI 助手寻求帮助。国内如豆包、KIMI 等工具都能提供很好的辅助。

祝安装顺利！ 🚀

# 人工智能 # java
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

Claude Code + CC Switch 初次配置使用记录

avatar AtomGit开源社区
cover

零Python/C++中间层！C#上位机+YOLOv9+PLC联动，汽车螺栓漏装99.99%实时检测全实战（附完整核心代码）

avatar AtomGit开源社区
cover

2026年只会SpringBoot和Python成为最先躺枪裁员的一批，公司上线Java + SpringAI+PyTorch On Java 大模型流水线，3个人干原来10个人的活

avatar AtomGit开源社区