外观
AI 编程工具入门:开始使用前需要准备什么
结论先说:开始前准备好四样东西——代码编辑器、Git、工具账号、能让命令行正常联网的环境。第一次使用时,从一个小项目和一个小任务开始,每次修改后用 Git 查看改了什么,不满意随时回退。
截图待补充
上线前补充实际操作截图并核验软件版本。
1. 两类 AI 编程工具
| 类型 | 工作方式 | 代表工具 | 适合谁 |
|---|---|---|---|
| 编辑器内助手 | 在你写代码时补全、解释、回答问题,由你决定是否采用 | GitHub Copilot、Cursor | 已经会写一些代码、想提高效率的人 |
| 编程代理 | 读取整个项目,自己规划步骤、修改多个文件、运行命令 | Claude Code、Codex | 想让 AI 完成整块任务的人,包括想用 AI 建站的新手 |
两类工具的界限正在变模糊:Cursor、Copilot 也提供代理模式,Claude Code 和 Codex 也能在编辑器中使用。新手可以按“我想自己写,还是想让 AI 先写”来选。
CClaude Code
在终端和编辑器中读懂项目、修改代码、运行命令
- 官方入口
- claude.com/product/claude-code
- 收费方式
- Claude 付费订阅或 API 按量付费
- 适合人群
- 开发者、想用 AI 建站的用户
- 教程
- Claude Code 介绍与教程
资料核验:2026-10-09
CCodex
OpenAI 的编程代理,可在本地或云端完成编程任务
- 官方入口
- openai.com/codex
- 收费方式
- ChatGPT 付费订阅或 API 按量付费
- 适合人群
- 开发者
- 教程
- Codex 介绍与教程
资料核验:2026-10-09
GGitHub Copilot
编辑器内代码补全与对话
- 官方入口
- github.com/features/copilot
- 收费方式
- 免费版 + 付费订阅
- 适合人群
- 使用 VS Code、JetBrains 的开发者
- 教程
- GitHub Copilot 介绍与教程
资料核验:2026-10-09
2. 准备清单
| 准备项 | 说明 | 检查方法 |
|---|---|---|
| 代码编辑器 | VS Code 是最常见的选择;Cursor 本身就是编辑器 | 能打开一个文件夹并编辑文件 |
| Git | 记录每次修改,AI 改错时可以回退 | 终端运行 git --version 能显示版本号 |
| 终端 | macOS 用“终端”,Windows 用 PowerShell | 能输入命令并看到输出 |
| 工具账号 | 不同工具对账号类型有要求,见下表 | 能在官网登录 |
| 网络环境 | 浏览器能打开不代表命令行也能联网 | 见第 5 节 |
| 一个练习项目 | 新建空文件夹,或复制一份不重要的项目 | 不要第一次就在重要项目上试 |
账号要求(以官方说明为准)
| 工具 | 账号要求 |
|---|---|
| Claude Code | 需要 Claude 付费订阅或 Anthropic API(Console)账号;官方文档说明免费版不包含 Claude Code |
| Codex | 可以用 ChatGPT 账号登录,也支持其他认证方式 |
| Cursor | 有免费的入门方案,可直接下载使用 |
| GitHub Copilot | 需要 GitHub 账号,有免费方案(功能和次数有限) |
3. 安装与首次运行
编程代理(命令行)
以下命令来自各工具官方文档,安装前请到官网确认是否有变化:
Claude Code:
bash
# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bashpowershell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex安装完成后 打开新的终端窗口,运行 claude --version 确认安装成功,再进入项目文件夹运行 claude,按浏览器提示登录。Windows 用户建议同时安装 Git for Windows。
Codex:macOS 和 Linux 可使用官方安装脚本,也可以通过 npm 或 Homebrew 安装;Windows 有单独的安装方式。安装后进入项目文件夹运行 codex,首次启动时按提示登录。
编辑器内助手
- Cursor:从官网下载安装,打开后登录,即可在编辑器中使用对话和补全。
- GitHub Copilot:在 VS Code 或 JetBrains 的扩展市场中安装 GitHub Copilot 扩展,用 GitHub 账号登录。
4. 第一个练习任务
用一个空文件夹做一个最简单的个人主页,整个过程能让你熟悉“提需求 → 看修改 → 验证 → 回退”的循环。
新建文件夹并初始化 Git:
bashmkdir my-first-site cd my-first-site git init启动编程代理(或在 Cursor 中打开该文件夹),输入:
text请在当前文件夹创建一个简单的个人主页: - 只用一个 index.html 文件,样式写在文件内; - 包含标题、一段自我介绍、三个链接; - 在手机上也能正常显示; - 完成后告诉我如何在浏览器中打开预览。 先说明你的计划,等我确认后再创建文件。确认计划后再执行。让 AI 先说计划,是避免它一次改太多的好习惯。
验证结果:双击
index.html在浏览器中打开,检查内容和手机宽度下的显示。提交一次:
bashgit add . git commit -m "第一个版本"接着提一个修改要求,例如“把配色改成深色主题”,然后用下一节的方法检查修改。
5. 检查和回退 AI 的修改
AI 编程工具会直接改你的文件,所以 每次让它改完都要看一眼改了什么:
| 想做的事 | 命令 |
|---|---|
| 看哪些文件被改了 | git status |
| 看具体改动内容 | git diff |
| 满意,保存这一版 | git add . 然后 git commit -m "说明" |
| 不满意,放弃所有未提交的修改 | git restore .(未提交的修改会丢失,执行前确认) |
关于命令执行权限
编程代理会请求运行命令的权限。新手阶段建议逐条查看再允许,尤其是涉及删除文件、安装软件、修改系统设置的命令。不要在含有密码、密钥等敏感信息的文件夹中使用,或先确认这些文件不会被读取和上传。
6. 网络问题:浏览器能打开,命令行却连不上
这是 AI 编程工具最常见的问题。原因是:很多命令行程序不读取系统代理设置,所以浏览器能正常访问官网,而安装脚本、登录或请求却超时。
常见表现:
- 安装命令长时间无响应或提示连接超时;
- 登录时浏览器授权成功,但终端一直等待;
- 使用中频繁提示网络错误、请求失败。
处理思路:
- 先确认浏览器能正常打开该工具的官网;
- 在代理客户端中开启 TUN 模式,让命令行程序的流量也经过代理;或在终端中设置代理环境变量(具体端口以你的客户端设置为准);
- 重新打开终端窗口后再试。
完整的检查步骤见 浏览器能访问,为什么应用程序连接失败;TUN 和系统代理的区别见 系统代理、TUN、规则和全局是什么关系。另外,这些服务都有各自的支持地区与使用条款,请先阅读并遵守所在地法律法规。
7. 新手常见问题
| 问题 | 建议 |
|---|---|
| 不会写代码能用吗 | 能做出简单的网页和脚本,但要学会用 git diff 看改动、在浏览器里验证结果 |
| AI 改坏了项目 | 用 git restore . 回到上一次提交;所以要养成频繁提交的习惯 |
| 提示词写不好 | 说清楚目标、限制条件和验收标准,并要求它“先说计划” |
| 额度很快用完 | 一次只给一个明确任务,避免让它反复读取整个大项目 |