AI编程小白到进阶：Cursor + Claude Code 实战指南

封面图：

图：Cursor 与 Claude Code 协同工作示意（AI 生成封面图，仅供演示）

1. 安装配置与项目接入

1.1 工具定位

工具	形态	适用场景
Cursor	图形化 IDE（基于 VS Code）	日常编码、文件编辑、智能补全、多文件重构
Claude Code	命令行 AI 代理	终端内对话、批量任务、自动化脚本、与 Git/CI 深度集成

1.2 安装步骤

步骤	操作详情	注意事项
1	访问 Cursor 官网下载并安装 Cursor	选择对应系统版本（Windows / macOS / Linux）
2	注册/登录 Cursor 账号，并配置 API Key（或订阅 Pro）	可使用 Claude 或 GPT 模型
3	安装 Node.js 16+（Claude Code 依赖）	用 `node -v` 检查
4	全局安装 Claude Code：`npm install -g @anthropic-ai/claude-code`	需要 npm 权限
5	在终端运行 `claude` 并登录	按提示完成 OAuth 认证

1.3 项目接入

# 在项目根目录终端启动 Claude Code
cd /path/to/your/project
claude
或在 Cursor 中打开项目后直接打开 Terminal 并运行 claude

Cursor 接入项目：

直接用 Cursor 打开项目文件夹；
使用 Cmd/Ctrl + L 打开 Chat；
使用 Cmd/Ctrl + K 打开代码生成框；
在设置中配置 Claude Code 作为外部工具或集成终端调用。

2. 用自然语言生成代码、重构和排查 bug 的核心指令技巧

2.1 高质量提示词公式

角色 + 任务 + 上下文 + 约束 + 例子 + 输出格式

示例：

你是一个资深 Python 后端工程师。请帮我编写一个 FastAPI 接口，支持用户注册，要求：
使用 Pydantic 校验 email 格式和密码长度
密码用 bcrypt 哈希存储
返回 JSON 格式的错误提示
并写一个单元测试用例
输出：两段代码，分别放入 app.py 和 test_app.py。

2.2 代码生成高级技巧

场景	提示词示例	效果提升要点
生成完整函数	“写一个记忆化递归的 Fibonacci”	明确输入输出和边界条件
生成测试	“为 `utils.py` 生成 pytest 用例，覆盖正常、异常、边界”	指定文件名和覆盖策略
生成配置	“帮我写一份 docker-compose.yml，包含 redis 和 postgres，并设置健康检查”	指定版本、端口、持久化
生成文档	“根据 `user.py` 生成 docstring，中英双语，包含参数和异常”	指明注释风格和语言

2.3 重构技巧

请重构以下代码，使其更简洁可维护，保持功能不变，并解释修改点：
[粘贴代码]

进阶指令：

“将这段代码拆分为多个函数，每个函数单一职责。”
“用 TypeScript interface 替换多余的 any，保留原有逻辑。”
“这块逻辑很绕，请用状态模式重构，并画出类关系图。”

2.4 排查 bug 技巧

target 错误信息 + 环境 + 已尝试的步骤 + 输入输出样例：

我在运行 test_users.py 时出现如下错误：
Traceback: [粘贴]
我的环境：Python 3.11, FastAPI 0.100, 使用本地 sqlite。
我已经确认数据库表存在，但插入数据时报错。请帮我分析可能的原因，并给出修复方案和验证方法。

关键点：给足上下文，让 AI 像结对编程伙伴一样理解你的代码，而不是凭空猜测。

3. 如何管理上下文窗口与项目规则

3.1 上下文窗口问题

AI 模型有最大 token 限制，因此需主动管理上下文。

问题	解决方案
对话太长丢记忆	定期开新会话，或用 `/clear` 清空历史
无关代码干扰	只选择相关文件或代码片段，不要全项目粘贴
项目规模太大	使用 `.claude/commands` 结构化任务，按模块查询

3.2 用 Project Rules 约束 AI

在项目根目录创建 .cursorrules 和 CLAUDE.md（Claude Code 自动读取）：

# CLAUDE.md 示例
项目语言
Python 3.10+
所有代码需要类型注解
风格规范
使用 black 格式化，行宽 88
导入顺序：标准库、第三方、本地
测试要求
任何新功能必须添加 pytest 测试，覆盖正常与异常路径
禁止事项
不要修改数据库迁移文件的已有内容
不要在代码中引入新的全局变量

3.3 会话管理技巧

- 每个任务一个会话，不要混用主题
当AI偏离方向时，用“停，我们回到刚才的需求，重申一遍：...”
用 /context 查看当前已加载文件，清理不相关文件
让AI总结关键决策到 CLAUDE.md，作为团队指南

3.4 Mermaid 流程图：上下文管理决策流程

graph TD A[开始新任务] --> B{任务复杂度} B -- 简单 --> C[在当前会话直接执行] B -- 复杂/跨模块 --> D[新建会话并加载项目规则] D --> E[收集相关文件路径] E --> F[在提示词中明确约束和输出格式] F --> G[执行AI生成/重构/修复] G --> H{结果满意?} H -- 是 --> I[更新 CLAUDE.md 记录经验] H -- 否 --> J[提供补充上下文或调整提示词] J --> G C --> I I --> K[结束]

4. 常见坑与安全风险规避

4.1 常见坑

坑	表现	应对方案
AI 生成代码过时	使用了已废弃 API	在规则中指定版本，并让它说明使用了哪些 API
上下文“遗忘”	多次回答不一致	用 `/new` 开启新会话，并携带项目要点
过分自信的错误修复	AI 声称修复但没验证	强制要求复述测试命令并运行验证
非法依赖或注入	生成的代码包含异常库或恶意命令	检查 package/requirements 变更
搞混代码库	修改了无关文件	使用白名单：`请在 src/ 目录内修改`

4.2 安全风险规避

绝不把密钥粘贴到对话中，使用环境变量：process.env.SECRET 或 os.getenv()。
不要盲目执行 AI 给出的 shell 命令，尤其涉及 rm -rf curl | bash 等。
审查 AI 对依赖的更改，在运行 npm install 或 pip install 前查看 diff。
限制 AI 的文件访问权限，在 Claude Code 中可配置 ignore 列表（如 .gitignore 中忽略敏感文件夹）。
签署 CLAUDE.md 为不可变规则，防止 AI 被 prompt injection 控制。

安全提醒：AI 生成代码仅供参考，生产环境使用前必须经过 code review 和安全测试。

5. 让 AI 编程助手与 Git/CI 流程协作

5.1 Git 集成

常用命令示例：

# 让 Claude Code 写 commit message
claude -p "请查看 git diff，并生成符合 conventional commits 规范的 commit message"
让 AI 创建分支并提交
claude -p "创建分支 feature/user-api，生成 user 模块的 CRUD 代码并提交"

Git 操作	提示词建议	注意
生成提交信息	`总结 diff，使用 feat/fix/docs 前缀`	确保 diff 不包含密钥
合并冲突	`帮我解决当前冲突，保留两个版本的数据库兼容逻辑`	人工复核语义
代码审查	`审查 staged changes，指出潜在bug和优化点`	AI 不能替代人工 review
回滚建议	`找出导致测试失败的最近提交，给出建议`	使用 `git bisect` 辅助

5.2 CI/CD 流程协作

将 AI 嵌入 CI 的典型模式：

# 在 GitHub Actions 中使用 Claude Code 进行代码审查（示例）
name: AI Review
on: [pull_request]
jobs:
 ai-review:
 runs-on: ubuntu-latest
 steps:
uses: actions/checkout@v4
name: Run Claude Code Review
 env:
 ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 run: |
 claude -p "只审查本次PR的改动，输出中文审查意见，并标记严重级别" > review.md
uses: actions/upload-artifact@v3
 with:
 name: ai-review
 path: review.md

最佳实践：

CI 中 AI 只做“建议者”，不做“阻止者”。可使用 continue-on-error: true。
将 AI 生成的代码自动跑单测，失败则不让 AI 提交。
用 git diff --check 让 AI 检查空白和冲突标记。

5.3 工作流总览：Mermaid 流程图

graph LR A[本地开发] --> B[Cursor 中生成/修改代码] B --> C[运行测试与 lint] C --> D{通过?} D -- 否 --> E[让 Claude Code 分析并修复] E --> C D -- 是 --> F[Git 提交 + 生成规范 commit message] F --> G[推送分支并创建 PR] G --> H[CI 触发: 运行全部测试 + AI 代码审查] H --> I{AI Review 输出意见} I --> J[开发者处理意见/人工 review] J --> K[合并到主干]

操作清单

安装 Cursor 并登录账号
安装 Node.js 和 Claude Code
在项目根目录启动 claude 并完成认证
创建 CLAUDE.md 和 .cursorrules，写入项目规则
练习用自然语言写出带约束的提示词（任务+上下文+输出格式）
体验一次代码生成：要求 AI 实现一个小功能（如登录接口）并写测试
体验一次重构：请求 AI 拆分一个长函数并保持功能不变
体验一次 debug：故意制造一个 bug，让 AI 根据报错定位并修复
在 Git 中练习让 AI 生成 commit message
在 CI 中配置一次 AI 代码审查并观察输出
检查所有对话中是否泄漏敏感信息
手动 review AI 生成的关键代码后再合并

避坑指南

坑	避坑策略
提示词过于模糊	使用结构化提示词，但不要一次要求太多功能
忽略项目已有架构	先让 AI 读取 README 或架构文档，再写代码
依赖 AI 而不看代码	关键逻辑必须人工理解，AI 适合初始生成和重复劳动
忘记更新规则文件	每次踩坑后把教训写入 CLAUDE.md
在共享屏幕上暴露密钥	使用终端隐私模式，或用环境变量替换
让 AI 覆盖不熟悉的语言/框架输出	显式要求 AI 注明“需要人工验证”或限制步数

名称	来源	链接/关键词	类型	备注
《Cursor 基础教程：AI编程助手入门》	B站 UP主：AI编程实战	在B站搜索该标题即可	B站免费视频	含界面操作演示
《Claude Code 实战：命令行 AI 编程》	腾讯视频创作者：码农学堂	在腾讯视频搜索“Claude Code 实战”	腾讯视频	偏终端工作流
《AI编程从入门到进阶完整指南》	优酷创作者：技术极客	在优酷搜索该标题	优酷视频	案例丰富，适合新手
《Cursor+Claude Code 组合工作流》	抖音创作者：AI开发圈	在抖音搜索“Cursor Claude Code”	抖音短视频	3分钟快速了解组合方法

免责声明

本教程由作者基于当前公开资料与个人实践撰写，旨在分享 AI 编程工具的使用方法。教程中提及的所有产品、商标、商标名称归其各自所有者所有。AI 生成代码可能存在错误、漏洞或不符合最佳实践，请务必在使用前进行审查、测试和合法合规性评估。作者不承担因使用本教程内容而产生的任何直接或间接损失。请在遵守相关软件许可和法律法规的前提下进行开发和部署。（完）

本教程为原创内容，首发于知乎/掘金/CSDN（请自行选择平台），欢迎分享给需要的朋友。