代码不在你电脑上：Git 与"把项目拉下来跑起来"
想让 AI 替你造工具，第一步是先把代码弄到自己手里、还能跑起来。
START
卡住你的，其实是这三件事
你已经想清楚了：与其一直用现成的工具，不如让 AI 帮你把一套自己的工具搭出来。可真到动手，第一道坎不是"AI 会不会写"，而是——
代码在别人给我的那个仓库里，我怎么弄到自己电脑上、还让它跑起来？
你打开那个链接，看到一堆文件夹和一个绿色按钮；有人告诉你"clone 一下就行"，可你连 clone 出来的东西该放哪、跑之前还要做什么都不清楚。卡住你的不是聪明不聪明，是没人跟你讲清楚：代码到底存在哪、凭什么能拿、拿下来为什么还跑不起来。这一篇就把这三件事讲透。
MODEL
先建立心智模型（比记命令重要）
Git 不是网盘同步，是"一人一个完整档案馆"
新手最大的误解，是把托管代码的地方当成网盘。它不是。远端有一个完整的仓库，你 clone 下来的也是一个完整的仓库——全部历史、全部版本都在本地。用词典的比喻：代码仓库（Repository）＝一座图纸档案馆，远端是总馆，你每台电脑 clone 一份就是自己的分馆，馆藏一模一样。关键结论：分馆之间不会自动实时同步。你想让别人看到你的改动，必须主动推上去（push）；想拿到别人的改动，必须主动拉下来（pull）。
一次改动，要走过三道门
改文件的地方叫工作区，但改完不等于存好了。挑（git add）：从改过的文件里挑出这次要记录的，放进暂存区。封（git commit）：打包成一次提交，写清"这次干了什么"，只存进本地。送（git push）：推到远端，别人才拿得到。关键区分：提交 ≠ 推送——commit 了只是存进你自己电脑，push 之前别人和另一台机器都看不到。忘了 push 就换机器，是新手第一大坑。
私有仓库为什么要先办身份证
你的项目仓库是私有的，远端必须先确认"你是谁、有没有权限"。所以新电脑第一件事不是敲 clone，而是给这台机器办身份证。推荐 SSH 密钥：你在本机生成一对钥匙，私钥留在自己电脑绝不外传，公钥交给远端；以后每次连接远端拿公钥出题，只有握私钥的机器答得上——全程不传密码。一句话：私钥是你家保险柜的钥匙只有你有，公钥是挂门口的锁谁装都行。
STEPS
把它走通一遍（macOS · 私有仓库 · SSH）
命令通用，换任何项目都是这一套。
第 0 步 · 确认 Git 在
git --version没有的话，macOS 会弹窗提示装命令行工具，同意即可。
第 1 步 · 设置身份（决定提交记录署谁的名）
git config --global user.name "你的名字"
git config --global user.email "你账号绑定的邮箱"邮箱要和你的代码托管账号一致，否则提交不会关联到你。
第 2 步 · 生成 SSH 密钥
ssh-keygen -t ed25519 -C "你账号绑定的邮箱"一路回车。会得到两个文件：id_ed25519（私钥，永远别发给任何人、别贴进聊天窗）、id_ed25519.pub（公钥，就是要交出去的那把锁）。
第 3 步 · 把公钥交给托管平台
复制公钥内容 → 打开平台账号设置 → 找到 "SSH keys" → 新增 → 粘贴保存。标题建议写清是哪台设备（如"工作机 MacBook"），日后好辨认。
第 4 步 · 验证连通
ssh -T git@github.com第一次问是否继续，输 yes；看到 "successfully authenticated" 就是通了。
第 5 步 · 克隆仓库（把档案馆搬到本地）
cd ~/Documents
git clone <你的仓库 SSH 地址>
cd <仓库名>clone 会自动建一个同名文件夹，别自己先建好文件夹再 clone。
第 6 步 · 确认拿到的是最新的
git remote -v
git log --oneline -10
git status第 7 步 · 装依赖、跑起来（最容易漏）
代码到了，但依赖包通常不在仓库里——它们被有意排除掉了。这正是词典那句"源码与生成物＝菜谱不是菜"：你 clone 到的是菜谱，不是做好的菜；换个厨房（新电脑）得照菜谱重做一遍。看项目根目录给的菜谱：有 package.json → npm install；有 requirements.txt → pip install -r requirements.txt；有 .env.example → 复制成 .env 填自己的配置（密钥类文件不进仓库，必须手动补）。装完依赖、补齐配置，才真正跑得起来。
RULE
两台机器来回切换：一条铁律
开工前先 pull，收工前必 push。
git pull # 开工：先拿另一台机器的最新
git status
git commit -m "说明这次做了什么" # 可多次 commit，不必每次都 push
git push # 收工：推上去，另一台才拿得到忘了 push 就换机器——另一台拉不到东西，两边各写各的，下次就撞成冲突。这条纪律的展开，是本专区下一篇的主题。
AI
这套流程怎么衔接 AI 开发
懂了上面这套，接 AI 编程工具只是多一层，而且它让 AI 更安全。
AI 工具是在你本地那份仓库里干活的，并不直接连远端。所以"先 clone 到本地"是用 AI 编程的前置条件，不是可选项。
Git 是 AI 编程的安全网：AI 一次可能改十几个文件，养成"让它动手前先 commit 一次"的习惯，改坏了随时退回干净状态——这是新手用 AI 编程最重要的一条纪律。
小步提交、写清说明：按功能拆成多次提交，review 和回退的粒度都可控。
让 AI 读得懂你的项目：在根目录放一份给 AI 读的项目说明（主流 AI 编程助手大多会自动读取约定位置的项目说明文件），把项目结构、技术栈、约定写进去，AI 输出质量会明显提升。
最后仍然是你在 push：确认改动合理了再推，判断权始终在你手里。
NEXT
下一步
你已经能把一个项目拉到本地、跑起来了。
自己学的下一步
只要你碎片时间开发、还换机器，很快会撞上"怎么不把自己的活弄乱"——下一篇《一个仓库、两台机器：并行开发不弄乱的秩序》把这条铁律展开成一套可运转的秩序。
读第 2 篇找我们做
如果你缺一双工程的手，想把设想里的那套工具直接搭出来——我们的 Agent 定制服务，可以帮你把它落到位。
查看服务伴读词条 · 概念词典第三层