Claude Code必装的基础环境依赖

一、3个重要的系统工具

Claude Code本体安装完成，并不意味着所有功能都能正常工作。Claude Code在运行过程中会调用一些系统级工具——如果这些工具缺失，部分功能会静默失败或报错。以下是各平台需要确认的依赖项：

依赖	用途	平台	重要性
Git	Checkpoint检查点（自动保存代码快照）、/diff差异对比、版本控制操作	全平台	必装，缺失将导致核心功能不可用
ripgrep (rg)	Claude Code的Grep工具底层依赖，用于高速代码搜索	全平台	通常Claude Code自带，一般无需手动安装
Xcode Command Line Tools	提供gcc、make等编译工具链，部分MCP Server安装时需要编译原生模块	macOS	macOS用户必装

二、检查方式

git --version 
# 应输出 git version 2.x.x
rg --version 
# 应输出 ripgrep 14.x.x（可选检查）
xcode-select -p 
# macOS终端应输出 /Library/Developer/CommandLineTools

三、安装Git

（一）Mac

macOS通常预装了Git（随Xcode Command Line Tools一起提供）。如果执行git –version无输出，最快的方式是安装 Xcode Command Line Tools，它会同时安装 Git。也可以通过Homebrew 单独安装：

brew install git

三项依赖中，Git是最关键的——没有Git，Claude Code的Checkpoint回滚机制将完全无法工作，/diff 命令也无法使用。请务必确认Git已正确安装后再继续。

（二）Windows

访问Git官方下载页：git-scm.com/downloads/win，下载64-bit Git for Windows Setup安装包。运行安装程序时，关键选项建议如下：

选项	推荐配置
Default Editor	选择你惯用的编辑器（如 VS Code）
PATH environment	选择 “Git from the command line and also from 3rd-party software”（默认项，确保终端可用）
Line ending	选择 “Checkout as-is, commit Unix-style”（适合跨平台开发）
其余选项	保持默认即可

（三）Linux

# Ubuntu / Debian
sudo apt update && sudo apt install git

# CentOS / RHEL / Fedora
sudo dnf install git

四、安装ripgrep

# macOS
brew install ripgrep
如果你还没有安装Homebrew，首先需要安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Windows（使用winget）
winget install BurntSushi.ripgrep.MSVC

# Linux（Ubuntu / Debian）
sudo apt install ripgrep

五、安装Xcode Command Line Tools

Xcode Command Line Tools包含了git、gcc、make、clang等开发者必备工具。macOS用户强烈建议安装——不仅 Claude Code需要，后续安装部分MCP Server（需要编译原生 Node.js模块）时也会依赖它。

xcode-select --install

执行后系统会弹出安装确认窗口，点击“安装”并等待完成（约5-10分钟，下载约1.5 GB）。

Claude Code必装的基础环境依赖

Published by AI全球充 on 2026-08-182026-08-18