2026 AI Coding 环境设置:GitHub、VS Code、Git、SSH、Claude Code、Codex 新手教程
AI Coding 环境的目标,是让代理在一个可保存、可回滚、可同步的项目里工作。直接安装 Agent,等它改完文件才想起版本管理,往往会让新手不敢接受任何改动。
六个工具各自负责什么
- VS Code:编辑器、终端、调试器和扩展的工作空间。
- Git:在本地记录每次变更,必要时可以比较和回退。
- GitHub:保存远程副本,支持协作与 Pull Request。
- HTTPS 或 SSH:让本机和 GitHub 建立安全连接。
- Claude Code、Codex:读取项目、修改文件、运行命令和协助验证的 AI Agent。
推荐安装顺序
第一步:创建私有仓库
在 GitHub 创建 Private Repository,建议先加入 README。练习项目也应写明用途、安装方式和运行命令,方便之后让 Agent 读取项目背景。
第二步:安装 Git 与 VS Code
安装后在终端运行 git --version 和 code --version 检查命令是否可用。Windows 与 macOS 的安装位置不同,但后续 Git 流程基本一致。
第三步:设置身份与连接
bash
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"小项目可以先使用 HTTPS;长期使用建议配置 SSH 密钥,并在 GitHub 中添加公钥。不要把私钥、令牌或 .env 文件提交到仓库。
第四步:完成第一次回滚路径
Clone 仓库后,新建一个小文件,执行 git status、git add、git commit 和 git push。只有亲手完成过一次提交和推送,才算真正拥有可回滚的工作流。
第五步:再接入 AI Agent
让 Claude Code 或 Codex 先阅读项目,再处理一个小任务。每次任务前后都查看 git diff,运行测试后再提交。不要一开始就授予 Agent 整个电脑或生产环境的权限。
为什么要建立 CLAUDE.md
CLAUDE.md 可以记录项目启动命令、目录约定、测试方式、禁止修改的文件和代码风格。它不是秘密配置文件,不应放 API Key;它的作用是让每次新会话都能快速获得稳定的项目上下文。
完成检查
- [ ] 能在本地打开项目并运行开发命令
- [ ]
git status、git diff和git log都能看懂 - [ ] 已完成一次 Commit 和 Push
- [ ] SSH 或 HTTPS 连接可用,密钥没有写进仓库
- [ ] Agent 只在目标项目目录内工作
- [ ] 已写明测试命令和回滚方法
来源
本文根据 AI 邮报原文 整理;可进一步参考 GitHub 设置 Git、GitHub SSH 文档、Claude Code VS Code 指南 和 Codex IDE 文档。