Skip to content

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 文档。

免责声明:本网站与 OpenAI 官方并无任何关联,不代表 OpenAI 官方立场。我们仅为用户提供 ChatGPT 相关的中文使用指南和资讯。