Claude Code 保姆级安装指南原文链接https://mp.weixin.qq.com/s/Pz6oM6gKKWaXNsNUPmC_Ow更新时间2026年3月13日阅读时长约17分钟一、Claude Code 是什么1.1 概念理解可以用一个比喻来理解 Claude 生态系统的三个层次概念比喻特点Claude运营商中国移动/电信大模型产品提供通信能力逻辑思考、代码编写、自然语言理解网页版 Claude公用电话需要手动拨号复制粘贴代码操作繁琐Claude Code智能手机终端设备官方定制终端自带传感器能直接读取文件、运行命令、提交 Git1.2 Claude Code 的核心能力✅自动扫描整个项目文件夹无需手动投喂代码✅直接运行测试并自动改错写完代码直接在电脑上运行✅操作终端打包、部署、写 Commit 一条龙服务✅文件系统操作直接创建、修改、删除文件1.3 与 OpenClaw 的区别维度Claude CodeOpenClaw定位超级程序员超级生活助理专注领域全链路代码开发与工程化落地通用 AI 智能助手多场景自动化执行模型支持单一模型Anthropic多模型支持记忆能力无原生长期记忆持久记忆与多任务同时执行结果输出多以文件形式输出可在聊天框交付或落地本地系统特点单任务快、token 消耗低、代码能力强多渠道交互适用场景更广二、安装前的准备工作2.1 网络环境准备必须先解决网络问题你懂我在说什么的确保能够访问 Claude 官方服务。2.2 终端工具准备Windows 用户检查是否已安装 Windows Terminal打开 PowerShell输入以下命令Get-Commandwt-ErrorAction SilentlyContinue如果有输出 → 已安装没有输出 → 需要安装安装 Windows Terminal在开始菜单搜索 “Microsoft Store” 或 “Store”搜索 “Windows Terminal”点击 “获取” 进行安装Mac 用户直接使用系统自带的 “终端”Terminal即可。三、Claude Code 安装方法方法一终端安装推荐这是最简单直接的安装方式。Mac 用户打开终端复制以下命令并回车curl-fsSLhttps://claude.ai/install.sh|bashWindows 用户搜索 “PowerShell”右键 → “以管理员身份打开”复制以下命令并回车irmhttps://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 虚拟机中的 Windows2.2 使用 Git 安装 Claude Code搜索并打开 “Windows Terminal”输入以下命令并回车irmhttps://claude.ai/install.ps1|iex等待安装完成会显示安装成功提示。方法三Node.js 安装如果前两种方法都失败可以尝试 Node.js 安装方式。3.1 下载 Node.js访问官网https://nodejs.org/zh-cn/downloadWindows 用户选择.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-vnode -v应显示类似v24.14.0的版本号npm -v应显示类似11.9.0的版本号3.4 使用 npm 安装 Claude Code在确保网络的前提下复制以下命令到终端并回车npm install-g anthropic-ai/claude-code--registryregistry⚠️注意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-helperinstall弹出是否继续时输入y并回车等待安装完成步骤 3配置 API Key使用方向键选择语言选择中文选择 GLM Coding Plan 套餐选择中国版粘贴刚才创建的 API Key配置成功后重新打开新的终端窗口使配置生效方案二使用 CC SwitchCC 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-fsSLhttps://claude.ai/install.sh|bash# Windows - 方法一推荐管理员权限运行 PowerShellirm https://claude.ai/install.ps1|iex# Windows - 方法二Git 安装# 1. 先安装 Githttps://git-scm.com/install/windows# 2. 运行安装命令irm https://claude.ai/install.ps1|iex# Windows/Mac - 方法三Node.js 安装# 1. 先安装 Node.jshttps://nodejs.org/zh-cn/download# 2. 验证安装node-vnpm-v# 3. 运行安装命令npminstall-ganthropic-ai/claude-code--registryregistry# 4. 验证安装claude--version# 验证安装成功claude最后提示如果在安装或使用过程中遇到任何问题都可以随时将错误信息截图发给 AI 助手寻求帮助。国内如豆包、KIMI 等工具都能提供很好的辅助。祝安装顺利