企业官网建设流程全解析

1. 面试官到底在问什么：项目上下文是怎么被“喂”进模型的

Agent 经典面试题里，“Claude Code、Cursor、Copilot 如何通过配置文件理解项目上下文”这道题，表面在问配置文件，实际在考你对 AI 编程工具上下文注入链路的理解。项目上下文指的是模型在生成代码前能看到的全部信息：当前文件、光标附近代码、目录结构、依赖清单、Git 变更、以及各类规则文件。配置文件的作用，就是把这些信息从“散落在磁盘上”变成“结构化地塞进 prompt”。

我试过把同一个需求分别丢给三个工具：给一个 NestJS 项目加一个分页 DTO。不写任何规则文件时，Copilot 补出来的 DTO 用的是 class-validator，Cursor 补出来的是 zod，Claude Code 则先反问“你们校验层用哪套”。差异的根源不是模型强弱，而是它们读取项目上下文的入口不同：Copilot 主要看当前文件和相邻文件，Cursor 会先查语义索引和.cursorrules，Claude Code 会主动读CLAUDE.md、settings.json并扫描目录树。

所以面试时你要讲清三件事：第一，每个工具的上下文来源有哪些；第二，配置文件在链路里处于哪一环；第三，配置写错时会出现什么症状。下面按“原问题 → 前置准备 → 可复制配置 → 验证 → 排障 → 工具选择”的顺序拆开，每个配置都给可复制的骨架和验证动作。

2. 前置准备：把项目上下文入口先摸清楚

在写配置之前，先确认三个工具各自的上下文入口文件叫什么、放在哪。这一步不做，后面配置写了也不知道有没有生效。

Claude Code 的入口分三层：项目根目录的CLAUDE.md（项目级记忆）、.claude/settings.json（权限与行为配置）、以及~/.claude/settings.json（用户级）。它还会读.claude/settings.local.json做本地覆盖。Cursor 的入口是项目根目录的.cursorrules（旧版）或.cursor/rules/*.mdc（新版规则目录），加上.cursorignore控制哪些文件不进索引。Copilot 的入口是.github/copilot-instructions.md，以及 VS Code 的settings.json里github.copilot.chat.codeGeneration.instructions字段。

如果你要把这些工具接到统一的中转层做请求观测，可以先在 TaoToken 控制台建一个 Key，后面验证请求时用得上。地址是 https://taotoken.net/api ，Key 在 console 里生成：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=console 。这一步不是必须，但做请求级验证时能看清上下文到底进了多少 token。

注意：配置文件里的路径一律用相对项目根目录的写法，绝对路径在换机器后会失效，这是最常见的“配置没生效”原因之一。

3. 可复制配置骨架：settings.json、config.toml 与规则文件

这一节给三套可直接抄的骨架。每套都标注了它影响上下文的哪一环。

3.1 Claude Code：CLAUDE.md + settings.json

CLAUDE.md是项目级记忆，内容会被注入每次会话的系统提示。写法上要短、要具体，别写成 README。

# 项目约定 - 语言：TypeScript strict 模式，禁止 any - 校验层：统一用 zod，禁止引入 class-validator - 目录：业务代码在 src/modules，公共工具在 src/shared - 测试：vitest，测试文件与源文件同目录，后缀 .spec.ts - 提交前必须跑：pnpm lint && pnpm test

.claude/settings.json控制权限和行为，决定 Claude Code 能读哪些目录、能跑哪些命令：

{ "permissions": { "allow": ["Read", "Glob", "Grep", "Bash(pnpm lint)", "Bash(pnpm test)"], "deny": ["Read(./.env)", "Read(./secrets/**)"] }, "context": { "include": ["src/**/*.ts", "package.json", "tsconfig.json"], "exclude": ["node_modules/**", "dist/**", "**/*.spec.ts"] } }

这里context.include决定扫描哪些文件进上下文，exclude把测试和产物排除掉，避免上下文被无关文件稀释。permissions.deny把.env挡在外面，防止密钥进 prompt。

3.2 Cursor：.cursor/rules 与 .cursorignore

新版 Cursor 用.cursor/rules/*.mdc，每个文件带 frontmatter 控制生效范围：

--- description: NestJS 模块开发规范 globs: src/modules/**/*.ts alwaysApply: false --- - 每个模块包含 controller、service、dto 三层 - DTO 用 zod schema 定义，通过 createZodDto 包装 - service 只依赖 repository，禁止直接注入 PrismaClient

globs是关键：它让规则只在编辑匹配文件时注入，而不是每次对话都塞进去。alwaysApply: true的规则会常驻上下文，适合放全局约定，比如“用 pnpm 不用 npm”。

.cursorignore控制索引范围，语法同.gitignore：

node_modules/ dist/ coverage/ *.log .env*

3.3 Copilot：copilot-instructions.md 与 VS Code 配置

Copilot 的项目级指令放在.github/copilot-instructions.md：

# 代码生成约定 - 使用 TypeScript，目标 ES2022 - 异步统一用 async/await，禁止 .then 链 - 错误处理用自定义 AppError，禁止裸 throw new Error - 导入顺序：node 内置 → 第三方 → 本地，组间空行

VS Code 侧可以在settings.json里追加指令文件路径，让多个仓库共享一套规则：

{ "github.copilot.chat.codeGeneration.instructions": [ { "file": ".github/copilot-instructions.md" }, { "text": "所有注释用中文，函数注释说明参数与返回值" } ] }

text字段适合放一两句全局约束，file字段适合放长规则。两者会合并注入。

4. 验证请求：确认上下文真的进了 prompt

配置写完不算完，要验证它有没有生效。三种工具验证方式不同。

Claude Code 在会话里输入/context可以看当前上下文占用，输入/memory能确认CLAUDE.md是否被加载。如果/memory里没列出你的项目文件，说明路径或权限配置有问题。更直接的办法是问它一个只有规则文件里才有的信息，比如“我们校验层用什么库”，答对说明注入成功。

Cursor 的验证靠行为观察：打开一个src/modules下的文件，让它生成一个 DTO，看是否用了 zod。如果它用了 class-validator，说明.cursor/rules的globs没匹配上。也可以在 Cursor 设置里搜 “Rules”，看规则文件是否被识别。

Copilot 的验证在 Chat 面板：输入@workspace 我们的错误处理用什么类，如果它答出AppError，说明copilot-instructions.md生效。注意@workspace才会触发项目级检索，普通补全只看当前文件。

如果你走 TaoToken 中转，可以在请求日志里看每次调用的 input tokens 数量。配置生效后，input tokens 会明显上升，因为规则文件和目录结构被注入了。模型对话入口在 https://taotoken.net/api ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc ，里面有各工具的 base_url 配置方式。

5. 本篇常见错排查

配置不生效，九成是下面几个原因。

规则文件位置放错。Cursor 的.cursorrules必须放项目根目录，放子目录不生效；新版.cursor/rules目录名不能拼错。Copilot 的copilot-instructions.md必须在.github目录下，放根目录不识别。

globs写得太窄或太宽。写src/**会匹配所有文件，规则常驻上下文，浪费 token；写src/modules/user/*.ts又可能漏掉嵌套目录。建议用src/modules/**/*.ts这种中间粒度。

.cursorignore把源码排除了。有人直接抄.gitignore，结果dist和node_modules排掉没问题，但把*.json也排掉，导致package.json不进索引，模型不知道你用了什么依赖。

Claude Code 的settings.json权限过严。deny里写了Read(./src/**)会导致源码读不进来，模型只能靠猜。排查时先把deny清空，确认能读后再逐条加回。

规则文件太长导致“中间遗忘”。超长规则里，开头和结尾的条目模型记得住，中间的被忽略。把最重要的约定放最前面，或者拆成多个.mdc文件按globs分发。

Copilot 补全不读项目指令。copilot-instructions.md只影响 Chat 和部分生成场景，行内补全主要看当前文件。想让补全遵守规则，得靠编辑器侧的instructions配置，且效果有限。

6. 面试怎么答与工具选择：把上下文链路讲成一条线

面试回答时，别背工具特性，把链路讲成一条线：项目里的配置文件 → 工具读取并结构化 → 注入 prompt 的上下文段 → 模型据此生成。Claude Code 走的是“记忆文件 + 权限配置 + 目录扫描”，Cursor 走的是“语义索引 + 规则文件 + globs 分发”，Copilot 走的是“项目指令文件 + 编辑器配置 + 当前文件”。三者链路长度不同，决定了它们适合的任务不同。

大型重构选 Claude Code，因为它能读全量目录并做全局影响分析；日常编码选 Cursor，因为规则文件能按文件类型精准注入，补全贴合项目约定；快速功能开发选 Copilot，因为它响应快、嵌入深，但上下文有限，不适合跨模块任务。长期维护的项目，把规则文件写细，比换工具更有效。

如果你在搭 Agent 或长期编码工作流，需要统一管理多个工具的请求和 Key，可以看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=coding-plan 。API Key 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=api-keys ，Claude Code 接入说明在 https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claudecode-anthropic 。配置骨架抄完先跑一遍验证，确认规则进了 prompt，再往规则里加内容，不然你永远不知道是哪条没生效。