Claude Code必装依赖：Git安装与配置全指南，从零到SSH密钥

去年开始我在本地折腾AI编程工具的时候，第一个卡住我的往往不是AI本身，而是环境依赖。很多教程上来就让你克隆仓库、跑命令，结果第一步就报了git找不到，然后整条链路全断了。这篇是Claude Code安装系列的第一篇，我先把最底层的Git讲透，你后面装Claude Code、拉代码、提交改动，全靠它撑场子。

先说结论：Claude Code本身是Node.js写的命令行工具，但它跑起来之后几乎所有跟文件、代码、版本相关的操作都走Git。没有Git，你连它的基础功能都用不了。所以这篇我按自己重装过无数遍系统的经验，把Git的下载、安装、配置、验证、避坑，按平台一步步拆开讲，新手照做就行，老手也可以直接跳到配置那块看看有没有遗漏。

1. 为什么Claude Code必须先装Git

1.1 Git到底是干什么的

Git是一个分布式的版本控制系统，说白了就是一个专门给代码做“存档”的工具。你写代码改坏了想回退，改到一半想看看昨天写的版本，甚至想同时维护好几个版本的代码，这些都是Git的看家本领。它跟Word里的“修订”很像，只不过强大了几个量级，而且是给整个项目做快照，不是只盯着一行字。

我经常用厨房打比方：你做饭的时候，每完成一个步骤就拍照记录，发现哪一步做砸了，就翻照片回到上一个状态重来。Git就是给代码项目不停拍照的工具，而且这个照片是完整的，连当时的环境都能还原。这个能力对AI编程尤其重要，因为AI生成的代码你不会每一行都审，出错概率高，有Git兜底才敢放心改。

1.2 Claude Code对Git的依赖到底有多深

很多人以为Claude Code只是一个对话工具，跟Git关系不大，这是最大的误解。实际上你跟Claude Code交互的时候，它会在当前目录里读取项目状态、查看文件变更、对比代码差异，这些操作底层全是Git在干活。

具体来说，Claude Code有几个核心功能完全离不开Git：

• 文件变更检测：Claude Code需要知道你对哪些文件做过修改，才能帮你审查代码、定位问题，这依赖Git的diff机制。
• 自动检查点：Claude Code在处理长时间任务时会创建checkpoint，方便你在出错时回滚到某一个中间状态，这套机制就是建立在Git提交之上的。
• 代码搜索与理解：它需要在项目里快速定位函数、类、引用关系，Git仓库的文件索引是它高效工作的前提。
• 与远程仓库交互：你要让Claude Code拉取远端代码、提交改动、推送到远程，那更是Git的主场。

所以你可以把Git理解成Claude Code的地基。地基没打好，上面盖的房子再漂亮也站不稳。这也是为什么我强烈建议你按照顺序来：先装Git，再装Claude Code，别跳步。

2. 动手安装前，先搞清楚这三件事

2.1 你的操作系统和CPU架构

安装前第一件事，确认你电脑的系统类型和处理器架构。大多数情况下你只需要做两步判断：操作系统是Windows、macOS还是Linux；CPU是x64（也就是Intel/AMD的64位）还是ARM（比如苹果的M系列芯片、部分Windows ARM设备）。

这一步看似基础，但真有人栽过跟头。我之前帮朋友远程看问题，他下载了Git安装包，双击提示无法安装，一看下载的是ARM64版本，而他的电脑是老的x64平台，白折腾了十分钟。反过来也一样，苹果M系列芯片上如果装了x64版本的Git，虽然能跑，但性能和兼容性多少有点影响。

教你一个最笨也最稳的方法：系统是哪个版本、芯片是什么型号，直接用搜索引擎查“怎么查看你的系统类型”，比你盲目猜测靠谱得多。

2.2 命令行版本就够了，别一上来就搞图形界面

Git有两种使用形态：一种是命令行工具，在黑乎乎的终端里敲git命令；另一种是图形化界面客户端，比如SourceTree、GitKraken这些。我的建议是以命令行版本为主。

原因很简单：Claude Code是终端里的工具，它调用的是Git命令，不是图形界面。而且你以后查资料、看教程，网上99%的Git操作讲解都是命令行，你跟着做才不会卡壳。图形界面可以等用熟了再装一个辅助看历史，但一开始别依赖它。

2.3 版本不要追新，但也不能太老

Git的版本迭代很快，功能也在不断增加。对于Claude Code这种工具来说，它使用的Git功能都不是特别激进，但也不能用十年前的老版本，否则部分命令行为和预期不一致。

我的建议是：只要你的Git是最近两三年内的版本，基本都没问题。如果版本太老，后面可能出现一些“莫名其妙”的兼容问题，排查起来很费劲。想要省心，就装官方最新稳定版，别用beta版。

3. Windows平台Git安装全程拆解

3.1 下载安装包

Windows系统装Git，标准路径是去Git官网下载安装包。打开官网之后，页面会自动识别你的系统，给出对应的下载按钮，一般会是一个64位的exe文件，几百兆大小，下载速度取决于你的网络环境。

如果你不确定下载哪个，注意看下载页面里的版本说明。一般会有“64-bit Git for Windows”和“32-bit Git for Windows”两个选项，现在主流电脑全是64位，选带64-bit的那个就行。苹果M系列用户也别急，Windows这边大概率还是x64。

下载完成后，双击exe文件启动安装程序。这时候如果你的系统弹出了用户账户控制（UAC）窗口，点“是”就行。安装界面是英文的，别慌，我下面把每个界面都给你过一遍。

3.2 安装向导里每个选项怎么选

Windows版Git的安装向导界面比较多，很多人就是在这里被劝退的。我按顺序把每个界面需要注意的选项讲一遍，你跟着选就完事了。

第一步是许可证界面，直接Next。第二步是选择安装路径，默认是C:\Program Files\Git，建议保持默认，除非你的C盘真的没空间了。

接下来是选择组件，默认选项基本合理，但有几个我建议你额外注意：

• “Additional icons”里的“On the Desktop”可勾可不勾，不影响使用。
• “Windows Explorer integration”里的“Git Bash Here”和“Git GUI Here”建议保留，这样你在文件夹里右键就能直接打开Git命令行，后面用Claude Code的时候很方便。
• “Associate .git configuration files”和“Associate .sh files”可以勾上，以后配置文件双击能用关联程序打开。
• 其他默认选项保持不动就行。

然后是选择开始菜单文件夹，直接Next。再往后是关键的选择默认编辑器，这里强烈建议你选“Use Visual Studio Code as Git's default editor”，前提是你装了VS Code。如果没有，选默认的Vim也不是不行，但Vim对新手太不友好，你到时候在终端里提交代码，不小心进了Vim界面，不知道该按哪个键退出。VS Code的编辑器友好得多，Claude Code用户后面也大概率会用到VS Code。

3.3 调整PATH环境变量，这一步千万别选错

安装向导进行到“Adjusting your PATH environment”这个界面时，有三个选项：

• “Use Git from Git Bash only”：只在Git Bash里能用git命令，这是最不推荐的选项。选了它，你在CMD或者PowerShell里敲git会提示找不到命令，Claude Code跑起来很容易出问题。
• “Git from the command line and also from 3rd-party software”：这个就是推荐的选项。它会把Git的可执行目录加到系统PATH里，你在CMD、PowerShell、VS Code终端里都能直接使用git命令。
• “Use Git and optional Unix tools from Command Prompt”：这个会把Git自带的Unix工具也加入PATH，可能覆盖系统原有工具，容易引发奇怪的冲突，一般不建议选。

正确的选择是中间那一项，也就是“Git from the command line and also from 3rd-party software”。这一步选错了，后面连git命令都找不到，很多人到这一步没注意，装完才发现终端里git不可用，又得重装，很浪费时间。

3.4 行结束符转换和终端模拟器怎么选

接着往下走，会碰到HTTPS证书验证方式的选择。第一项是“Use the OpenSSL library”，第二项是“Use the native Windows Secure Channel library”。对大多数人来说，OpenSSL是社区通用选择，兼容性好，遇到一些自签名证书的仓库也好配置，推荐选第一项。

然后是行结束符（line ending）转换，这一步也是新手最容易看懵的地方。选项是：

• “Checkout Windows-style, commit Unix-style line endings”：推荐选项。就是说从仓库里拉取代码时转换成Windows的CRLF换行，提交时再转换成Unix的LF换行。这个设置能最大程度避免跨平台项目里的换行符混乱问题。
• “Checkout as-is, commit Unix-style line endings”：仓库里是什么样就什么样，提交时按Unix风格。适合你确定所有项目都以Unix换行为准的场景。
• “Checkout as-is, commit as-is”：完全不做转换，适合单平台小项目，但多人协作时容易出问题。

对Claude Code这种需要跨平台运行的工具项目来说，选推荐的“Checkout Windows-style, commit Unix-style line endings”最省心。这一步后面还可以通过git config来改，但第一次就选对，能少踩不少坑。

再往下是终端模拟器的选择。“Use MinTTY”和“Use Windows' default console window”两个选项，我推荐MinTTY。虽然Windows的默认控制台现在也支持不少功能，但MinTTY的色彩渲染更真实，命令行体验更接近Linux/macOS，Claude Code的输出有颜色高亮时，用MinTTY看会更清楚。

后面几个界面，包括git pull的默认行为、凭据管理器、额外选项等，保持默认即可。凭据管理器默认的“Git Credential Manager”建议保留，它能在你推拉远程仓库时自动弹出登录窗口，省去你手动输入用户名密码的麻烦。实验选项不要勾选。

装完之后，推荐先重启一次终端窗口，让环境变量生效。

4. macOS和Linux安装Git

4.1 macOS的两种安装方式

macOS装Git，我推荐用Homebrew，前提是你已经装了Homebrew。没装的话，先装Homebrew，然后在终端里执行：

bash复制brew install git

它会自动安装最新稳定版，并且帮你把PATH配置好，省心。装完之后，用git --version验证一下，确认输出里有版本号。

如果你不想装Homebrew，也可以直接触发系统自带的命令行工具安装。在终端里输入git --version，macOS会弹窗提示安装Xcode Command Line Tools，确认之后系统会自动下载安装，装完就是可用的Git。

这两种方式我踩过坑的经验是：如果你打算长期用终端做开发，建议老老实实装Homebrew，因为Claude Code以后还会用到Node.js、其他命令行工具，Homebrew能统一管理，比什么都靠系统自带省心得多。

4.2 Linux不同发行版的安装命令

Linux发行版很多，我按最常见的两类来说。

Debian/Ubuntu系，用apt命令：

bash复制sudo apt update
sudo apt install git

CentOS/RHEL/Fedora系，用yum或dnf命令：

bash复制sudo yum install git
# 或者
sudo dnf install git

安装完成后，一样用git --version验证。如果你发现系统仓库里的版本比较旧，可以用一些第三方源安装比较新的版本，但对一般使用来说，系统源里的版本已经够用了。

4.3 安装完先别急，验证一下再说

不管你是Windows、macOS还是Linux，装完Git的第一件事，是打开终端输入：

bash复制git --version

正常会输出类似git version 2.39.2.windows.1这样的版本信息。只要能看到版本号，就说明Git核心已经安装成功。

如果你在终端里输入git --version，Windows上提示“git不是内部或外部命令”，macOS/Linux上提示“command not found”，说明安装有问题或者PATH没配好，直接跳到第六部分去排查。

5. 安装完成后必做的配置，一个都不能少

5.1 配置用户名和邮箱，不然没法提交

Git安装好之后，第一件要做的事是告诉Git你是谁。这个身份信息会记录在你每一次提交里，Claude Code帮你生成提交记录的时候，也需要用到它。

打开终端执行：

bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

这里有个细节：邮箱用什么取决于你用的远程仓库托管平台。如果用GitHub，建议用一个跟GitHub账号绑定的邮箱，这样提交记录能关联到你的账号。如果你不想暴露真实邮箱，GitHub也提供隐私邮箱，在GitHub设置里可以查到。我一开始用了不相关的邮箱，后来发现提交头像和账号对不上，还得回头改，浪费时间。

配置完成之后，可以用下面这个命令确认：

bash复制git config --list

它会把所有git配置列出来，你只要看到user.name和user.email被正确输出了，就说明配置成功。

5.2 默认分支名和换行符，建议顺手改掉

两个看着不起眼但实际很影响体验的配置，我建议你装完顺手设置好。

第一个是默认分支名。Git默认创建的主分支叫master，但现在很多远程托管平台统一用main。为了避免以后本地仓库分支名和远端不一致，建议设置：

bash复制git config --global init.defaultBranch main

设置之后，你git init创建的仓库主分支就是main，推送到远端时不容易出现分支名对不上的情况。

第二个是pull的行为。如果团队里有人忘了设置rebase行为，git pull默认会用merge，会多出一条merge commit，历史比较杂乱。我建议你设置成：

bash复制git config --global pull.rebase false

这样git pull的行为就是默认的merge，不会出现奇奇怪怪的状态。当然这个更多是个人偏好，Claude Code对这块没有强制性要求，但提前统一能少很多配合上的摩擦。

5.3 生成SSH密钥，为远程仓库操作做准备

Claude Code在操作远程仓库时，经常需要你拉取代码、推送提交。如果用HTTPS方式，每次都要输入用户名密码，即使有凭据管理器也不是最顺滑的体验。用SSH密钥登录，一次配置，长期免密，是效率最高的方式。

生成SSH密钥的命令是：

bash复制ssh-keygen -t ed25519 -C "你的邮箱"

一路回车，让它生成到默认路径即可。如果系统提示ed25519不被支持（老系统可能这样），可以改用RSA：

bash复制ssh-keygen -t rsa -b 4096 -C "你的邮箱"

生成的公钥文件和私钥文件会保存在用户目录下的.ssh文件夹里，其中.pub后缀的是公钥。打开公钥文件，把里面的内容复制出来，添加到你的远程仓库托管平台SSH keys设置里。

这一步在Claude Code的日常使用里非常重要。你会发现配置好SSH之后，无论拉代码还是推改动，都不需要再来回输密码，流畅度提升明显。我见过太多人卡在这一步，后来发现只是公钥没加到平台上，几十秒就能解决的事，绕了一大圈。

5.4 验证SSH连接

生成并添加公钥之后，建议立刻验证一次连接是否通。以最常见的平台为例：

bash复制ssh -T git@github.com

如果看到类似“Hi 用户名! You've successfully authenticated”的提示，说明SSH已经配通了。这一步验证通过，后面用Claude Code操作远程仓库就会非常顺畅。

6. 常见问题与排查技巧实录

6.1 终端提示“git不是内部或外部命令”

这个是最经典的问题，Windows上尤其常见。原因基本都是安装时PATH那一步选错了，或者没有重启终端让环境变量生效。

处理方式很简单。先重启终端试一次，如果还是不行，就把Git安装目录下的cmd文件夹完整路径加到系统环境变量PATH里。具体路径一般是：

text复制C:\Program Files\Git\cmd

加好之后重新打开终端，git --version就能识别了。这个问题我在重装系统后遇到过好几次，每次都靠这个方式解决，两分钟搞定。

macOS/Linux上如果报command not found，一般是安装源有问题或者安装失败，重新执行安装命令试一下，大概率能解决。

6.2 版本太旧，功能行为不一致

如果你装的Git版本太老，你会发现Claude Code在执行某些操作时行为不对，比如文件变更检测不到、提交信息格式不对。别去查各种复杂原因，先看一眼git --version。

我在一台旧服务器上就遇到过，系统自带的git还是1.8版本，跑起来很多命令都要加额外参数，体验很差。后来把系统源里的Git升级到新版，所有问题都消失了。遇到奇怪的git行为，先升级版本再排查，性价比最高。

6.3 换行符警告和SSL连接问题

在Windows上操作跨平台项目时，你可能会看到类似“warning: LF will be replaced by CRLF”的提示，这是正常的换行符转换警告，不影响使用。如果你实在不想看到，可以把core.autocrlf设为false，但我不建议这么做，因为跨平台项目里这能避免很多隐藏的格式问题。

SSL连接问题则多见于自建仓库或公司内网仓库。如果你在git操作时遇到SSL证书验证失败，可以先确认一下仓库地址是不是https开头、证书是否过期。如果是自签名证书，要么让管理员帮你把证书配置好，要么临时关闭证书验证（不推荐，除非在你完全信任的内网环境）。

6.4 常见问题速查表

我自己的习惯是每次装完Git，都会顺手跑一遍git --version和git config --list两个命令，确认版本和配置都对，再进入下一步装Claude Code。这个习惯帮我省了不少排查时间，建议你也养成。

顺带说一个小技巧，如果你后面要用VS Code配合Claude Code，装完Git之后最好在终端里执行一下：

bash复制git config --global core.editor "code --wait"

这样凡是需要git打开编辑器写提交信息的时候，都会自动用VS Code，而不是Vim。别问我为什么特别提这个，我第一次在终端里被Vim困住的时候真有想过砸键盘。

Git装好、配好、验证通过之后，Claude Code的核心依赖就齐了一大半。下一篇我会接着讲Node.js环境的安装与版本管理，这同样是Claude Code运行必不可少的环节，装上之后你就可以真正开始体验AI编程工具带来的效率变化了。