• 首页
  • 博客
  • 项目
  • 留言墙
  • AMA 咨询
Community社区成员
Make it
happen

© 2026 Chenyun.cherishbloom

首页博客项目留言墙AMA 咨询
  • 一、系统要求与环境准备
  • 1.1 支持的操作系统
  • 1.2 前置要求
  • 1.3 环境检查
  • 二、Claude Code 一键安装
  • 2.1 自动安装方式 (推荐)
  • Linux/macOS 系统
  • Windows 系统
  • 2.2 手动安装方式
  • 1. 安装/更新 npm
  • 2. 全局安装 Claude Code
  • 3. 验证安装
  • 2.3 权限配置 (Windows 特殊处理)
  • Git Bash 权限配置
  • PowerShell 权限配置(哈尔斯终端处理)
  • 三、Claude Code 快捷命令与配置
  • 3.1 基础快捷命令
  • 3.2 自动模式配置
  • 设置自动执行权限
  • 3.3 高级操作技巧
  • 权限模式切换
  • 计划模式启动
  • 快捷键
  • 3.4 全局记忆设置
  • 设置中文环境
  • 项目初始化
  • 设置项目特定规则
  • 四、MCP 工具配置与使用
  • 4.1 MCP 工具概述
  • 4.2 智谱平台 MCP 工具配置
  • 4.2.1 基础配置命令格式
  • 4.2.2 智谱平台推荐工具
  • 4.3 其他实用 MCP 工具
  • 4.4 MCP 工具管理命令
  • 查看已安装工具
  • 删除工具
  • 作用域管理
  • 4.5 MCP 配置文件
  • 4.6 使用示例
  • 地图查询示例
  • 天气查询示例
  • 网络搜索示例
  • 五、常见问题与故障排除
  • 5.1 安装相关问题
  • 问题1: npm 权限错误 (EACCES)
  • 问题2: Node.js 版本过低
  • 问题3: 网络连接问题
  • 5.2 配置相关问题
  • 问题1: .bashrc 文件不生效
  • 问题2: MCP 工具安装失败
  • 5.3 使用相关问题
  • 问题1: 命令无响应
  • 问题2: MCP 工具无法使用
  • 问题3: 内存不足问题
  • 5.4 升级与维护
  • 升级 Claude Code
  • 清理缓存
  • 六、高级使用技巧
  • 6.1 项目工作流
  • 1. 新项目初始化
  • 2. 团队协作配置
  • 6.2 性能优化
  • 1. 减少上下文大小
  • 2. 批量操作
  • 6.3 自动化集成
  • 1. Git 钩子集成
  • 2. CI/CD 集成
  • 七、卸载 Claude Code
  • 7.1 完全卸载步骤
  • 1. 卸载 Claude Code
  • 2. 清理配置文件
  • 3. 手动清理残留文件
  • 7.2 验证卸载
  • 八、总结与建议
  • 8.1 最佳实践建议
  • 8.2 相关资源
Claude Code 保姆级教程
2026/03/03claude code

Claude Code 保姆级教程

本文讨论了Claude Code的保姆级教程，涵盖系统要求、安装方式、快捷命令、MCP工具配置、常见问题解决、高级使用技巧、卸载方法以及最佳实践建议等内容。关键要点包括： 1. 系统要求与环境准备：支持Windows 10/11、macOS 10.14+、Linux主流发行版；需Node.js 16.0或更高版本、npm和Git。 2. 安装方式：有自动和手动两种安装方式，自动推荐，手动需先安装/更新npm，再全局安装Claude Code，Windows需进行权限配置。 3. 快捷命令与配置：有基础快捷命令，可设置自动模式，掌握高级操作技巧和全局记忆设置。 4. MCP工具配置与使用：MCP工具可扩展Claude Code功能，介绍了智谱平台推荐工具、其他实用工具、管理命令、配置文件及使用示例。 5. 常见问题与故障排除：针对安装、配置、使用相关问题给出解决方案，还介绍了升级与维护方法。 6. 高级使用技巧：包括项目工作流、性能优化和自动化集成。 7. 卸载与建议：提供完全卸载步骤和验证方法，给出最佳实践建议并列举相关资源。

72次点击15分钟阅读

Claude Code 保姆级教程

一、系统要求与环境准备

1.1 支持的操作系统

  • Windows: Windows 10/11 (推荐使用 Git Bash 或 PowerShell)
  • macOS: macOS 10.14+
  • Linux: Ubuntu 18.04+, CentOS 7+, 其他主流发行版

1.2 前置要求

  • Node.js: 版本 16.0 或更高
  • npm: 包管理器 (通常随 Node.js 安装)
  • Git: 用于版本控制 (可选但推荐)

1.3 环境检查

# 检查 Node.js 版本 node --version

# 检查 npm 版本 npm --version

# 检查 Git 版本 git --version

二、Claude Code 一键安装

2.1 自动安装方式 (推荐)

Linux/macOS 系统

Windows 系统

方法1: 使用 Git Bash

方法2: 使用 PowerShell

2.2 手动安装方式

1. 安装/更新 npm

确保您的系统已安装最新版本的 npm。

2. 全局安装 Claude Code

3. 验证安装

2.3 权限配置 (Windows 特殊处理)

Git Bash 权限配置

如果首次运行 Git Bash 时遇到警告，系统会自动创建 .bash_profile 文件，您可以忽略该警告。

PowerShell 权限配置(哈尔斯终端处理)

如果遇到权限问题，请以管理员身份运行 PowerShell，然后执行：

三、Claude Code 快捷命令与配置

3.1 基础快捷命令

3.2 自动模式配置

设置自动执行权限

由于 Claude Code 默认在执行命令时需要用户确认，可以通过以下命令启用自动模式：

# 启用自动权限模式 claude --dangerously-skip-permissions

3.3 高级操作技巧

权限模式切换

  • Shift+Tab: 循环切换权限模式
    • ⏵⏵ accept edits on - 自动接受模式
    • ⏸ plan mode on - 计划模式

计划模式启动

# 以计划模式启动新会话 claude --permission-mode plan

快捷键

  • @文件名: 精准引用分析文件
  • #: 快速编辑 CLAUDE.md 文件
  • !: 执行 bash 命令
  • \+Enter: 换行输入
  • Ctrl+L: 清屏

3.4 全局记忆设置

设置中文环境

项目初始化

# 使用 /init 命令初始化项目 /init

Claude Code 会自动分析项目结构并生成中文内容的 CLAUDE.md 文件，该文件会记录：

  • 常用的 bash 命令
  • 核心代码文件
  • 实用函数
  • 代码风格信息

一般用于已经存在的项目中，与memory一样都是编辑CLAUDE.md文件

设置项目特定规则

使用 # 号开头直接添加规则，编写的命令CLAUDE.md的模板格式如下：

四、MCP 工具配置与使用

4.1 MCP 工具概述

MCP (Model Context Protocol) 工具是 Claude Code 的扩展功能，可以为其添加各种第三方服务的能力。Claude Code 自带基础联网搜索功能，但通过 MCP 工具可以实现深度搜索、地图服务、天气查询等高级功能。

4.2 智谱平台 MCP 工具配置

4.2.1 基础配置命令格式

# 通用添加命令格式 claude mcp add 工具名称 配置参数

4.2.2 智谱平台推荐工具

1. GLM 视觉理解工具

2. 高德地图服务

3. 墨迹天气服务

4. 网络搜索工具

4.3 其他实用 MCP 工具

4.4 MCP 工具管理命令

查看已安装工具

# 列出所有已安装的 MCP 工具 claude mcp list

# 查看 MCP 工具状态 /mcp

删除工具

作用域管理

4.5 MCP 配置文件

MCP 工具的配置信息会保存在项目目录下的 .mcp.json 文件中，该文件会记录：

  • 已安装的工具列表
  • 工具配置参数
  • API 密钥和令牌
  • 作用域设置

4.6 使用示例

地图查询示例

安装高德地图工具后，您可以直接询问：

  • "帮我查找北京市的天气"
  • "显示从北京到上海的路线"
  • "附近有什么餐厅？"

天气查询示例

安装墨迹天气工具后，您可以：

  • "查询今天的天气情况"
  • "明天会下雨吗？"
  • "未来一周的天气预报"

网络搜索示例

安装高级搜索工具后，您可以：

  • "搜索最新的科技新闻"
  • "查找某个技术文档"
  • "了解某个公司的背景信息"

五、常见问题与故障排除

5.1 安装相关问题

问题1: npm 权限错误 (EACCES)

现象: npm install -g @anthropic-ai/claude-code 提示权限不足

解决方案:

问题2: Node.js 版本过低

现象: 安装时提示 Node.js 版本不符合要求

解决方案:

问题3: 网络连接问题

现象: 下载安装脚本失败或超时

解决方案:

5.2 配置相关问题

问题1: .bashrc 文件不生效

现象: 配置的快捷命令无法使用

解决方案:

问题2: MCP 工具安装失败

现象: 添加 MCP 工具时报错

解决方案:

5.3 使用相关问题

问题1: 命令无响应

现象: 输入命令后程序卡住解决方案:

# 强制退出当前会话 Ctrl+C

# 重启 Claude Code claude

# 检查系统状态 claude --status

问题2: MCP 工具无法使用

现象: 安装的 MCP 工具无法正常工作

解决方案:

问题3: 内存不足问题

现象: 处理大文件时程序崩溃

解决方案:

5.4 升级与维护

升级 Claude Code

# 升级到最新版本 npm update -g @anthropic-ai/claude-code

# 检查当前版本 claude --version

清理缓存

# 清理 Claude Code 缓存 rm -rf ~/.claude/cache

# 清理 npm 缓存 npm cache clean --force

六、高级使用技巧

6.1 项目工作流

1. 新项目初始化

2. 团队协作配置

6.2 性能优化

1. 减少上下文大小

2. 批量操作

6.3 自动化集成

1. Git 钩子集成

2. CI/CD 集成

七、卸载 Claude Code

7.1 完全卸载步骤

1. 卸载 Claude Code

# npm 卸载 npm uninstall -g @anthropic-ai/claude-code

2. 清理配置文件

⚠️ 重要提示: 大多数安装失败都是由于旧版本文件未完全清除导致的。必须彻底删除以下位置的残留文件：Windows 系统:

# 删除主目录下的配置文件

rm -rf ~/.claude

rm -f ~/.claude*

rm -f ~/.bashrc*

Linux/macOS 系统:

3. 手动清理残留文件

检查并删除以下位置的文件：

  • C:\Users\用户名\.claude\
  • C:\Users\用户名\.claude*
  • 项目目录中的 .mcp.json
  • 项目目录中的 CLAUDE.md

7.2 验证卸载

八、总结与建议

8.1 最佳实践建议

  1. 环境准备: 确保使用最新稳定的 Node.js 版本
  2. 权限管理: 合理配置自动模式和权限级别
  3. 工具配置: 根据需要选择性安装 MCP 工具
  4. 项目管理: 为每个项目配置专属的 CLAUDE.md
  5. 定期维护: 定期升级和清理缓存

8.2 相关资源

名称

描述

智谱AI开放平台

智谱AI的官方开放平台，提供GLM模型的API服务和开发者工具

Z.ai Chat

由GLM-4.5驱动的免费AI聊天机器人，支持文本生成、推理和深度研究

Zread AI

GitHub仓库的AI代码维基，提供多语言指南、架构洞察和社区讨论

GLM-CC

将GLM-4.5与Claude Code等Vibe Coding工具集成，提供一键安装脚本

Claude Code官方文档

Anthropic官方的Claude Code智能编程工具文档

Claude Code最佳实践

Anthropic官方的Claude Code代理编码最佳实践指南

Claude Code SDK

Anthropic官方的Claude Code SDK调用，支持python和type

Node.js下载

Node.js官方下载页面，提供免费、开源、跨平台的JavaScript运行时

Claude Code Router

使用Claude Code作为编程基础设施基础，可自定义模型交互方式

Opcode

Claude Code的强大GUI应用和工具包，支持创建自定义代理、管理交互会话等

CCPM

使用GitHub Issues和Git worktrees的Claude Code项目管理系统

CCPlugins

实际节省时间的Claude Code框架，内置高级工程师生成提示

Sniffly

分析Claude Code日志的工具，提供使用统计、错误分析和可共享仪表板

Claude Code Log

将Claude Code JSONL转录转换为可读HTML，支持TUI和交互式过滤

Awesome Claude Code

精选的Claude Code命令、文件和工作流列表

Spec Kit

帮助您开始规范驱动开发的工具包

CC-SDD

为Claude Code、Cursor和Gemini CLI安装AI-DLC与SDD工作流，提供10个斜杠命令

Claude Code Spec Workflow

Claude Code的自动化工作流，支持新功能的规范驱动开发和简化的错误修复流程

Agents

Claude Code的生产就绪子代理集合，包含83个专门的AI代理

OpenAI Agents.md

指导编码代理的简单开放格式规范

Context Engineering

关于上下文设计、编排和优化的前

总浏览量 1,930
最近访客来自 Columbus, US🇺🇸