> ## Documentation Index
> Fetch the complete documentation index at: https://aicoding.cscitech.top/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Coding 入门

> 先理解 AI Coding 的工作方式、适用边界和实践方法，再进入 Codex 完整教程。

# AI Coding 入门

在学习具体工具之前，先理解 **AI Coding** 是什么。AI Coding 不是某一个产品的名称，而是一种把人工智能融入软件开发全过程的工作方式。

你可以把它理解为：**人负责目标、判断和取舍，AI 负责理解上下文、生成方案、修改代码和执行验证，双方通过持续反馈完成开发。**

## AI Coding 解决什么问题

传统编程主要依靠开发者手动完成查资料、读代码、写代码、调试和测试。AI Coding 则把其中一部分工作交给能够理解自然语言和代码的模型协助完成。

它可以帮助你：

* 快速了解陌生项目的目录结构、关键模块和调用关系；
* 把自然语言需求整理成任务清单、技术方案和验收标准；
* 生成样例代码、测试代码、脚本和文档；
* 根据报错、日志和复现步骤定位问题；
* 修改或重构代码，并解释每一处重要变更；
* 检查差异、运行测试，为提交和发布准备结果。

AI Coding 的重点不是“让 AI 替你写完所有代码”，而是让开发者把更多时间放在问题定义、方案判断、质量验收和产品取舍上。

## 一次协作如何完成

一个可靠的 AI Coding 任务通常会经历下面的闭环：

1. **说明目标**：告诉 AI 要解决什么问题，以及什么结果算完成。
2. **提供上下文**：补充项目结构、相关文件、约束条件、报错信息和参考资料。
3. **先做计划**：让 AI 复述理解、列出步骤，并指出不确定之处。
4. **分步执行**：让 AI 读取代码、修改文件、运行命令或生成测试。
5. **检查结果**：查看 diff，运行测试，确认行为符合预期。
6. **继续反馈**：针对失败或遗漏提供新的信息，直到任务达到验收标准。

这个过程本质上仍然是工程协作。AI 可以加快执行速度，但不能替你承担需求判断、代码审查和上线责任。

## 什么时候适合使用

AI Coding 特别适合边界清楚、反馈及时、容易验证的任务，例如：

| 任务类型    | 适合的协作方式                        |
| ------- | ------------------------------ |
| 探索陌生代码库 | 先让 AI 输出目录、入口和调用链，再逐个确认关键模块    |
| 修复 Bug  | 提供复现步骤和日志，让 AI 先定位原因，再补回归测试    |
| 开发小功能   | 先写清输入、输出、边界条件和验收标准，再分步实现       |
| 重构代码    | 先限定不变的行为和影响范围，修改后重点检查 diff 与测试 |
| 编写文档和脚本 | 给出目标读者、运行环境和输出格式，并实际执行验证       |

涉及支付、权限、安全、隐私、生产数据或大规模架构时，需要更严格的人工评审和更小的操作范围。不要因为 AI 给出了看起来合理的答案，就跳过测试和审批。

## AI Coding 的边界

模型可能会误解需求、遗漏上下文、生成不存在的 API，或在代码看似正确时引入隐藏问题。因此，使用 AI Coding 时要坚持四个原则：

* **先小后大**：把大型目标拆成可以独立检查的小任务；
* **先读后改**：让 AI 先了解现状，不要直接覆盖未知代码；
* **先看 diff 再接受**：任何修改都要知道改了什么、为什么改；
* **先验证再交付**：运行测试、检查日志，并按真实场景验收。

## AI Coding 与 Codex 的关系

AI Coding 是方法论，Codex 是实践这种方法的一类 AI 编程代理。Codex 可以读取项目上下文、调用工具、修改文件、运行验证，并在不同入口中协助完成开发任务。

理解 AI Coding 后，再学习 Codex 会更容易：你关注的不只是某条命令怎么写，还会知道什么时候应该补充上下文、什么时候先做计划，以及什么时候必须停下来人工审查。

## 接下来学习 Codex

如果你已经理解了 AI Coding 的基本工作方式，可以进入 [Codex 完整教程](/index)，从 [认识 Codex](/01-认识-Codex/01-Codex是什么) 开始，逐步学习安装、入口、工作流、安全、扩展和工程化实践。