AI 编程智能体配置指南（中文）

每个主流编程 agent 都提供两种手段：一是完全自动批准的开关（Cursor 的 Run Everything、Claude Code 的 --dangerously-skip-permissions、Codex、Gemini CLI 和 Copilot CLI 的 --yolo、Cline 的 YOLO Mode），二是有范围限制的 allowlist，只预先批准你信任的命令。allowlist 是更安全的默认选择。完全开关请只用于容器、虚拟机或一次性项目。

Cursor 读取 .cursor/rules 中的 .mdc 文件以及 AGENTS.md。Claude Code 读取 CLAUDE.md，没有 CLAUDE.md 时回退到 AGENTS.md。Codex、Amp、Kiro 和 Junie 原生读取 AGENTS.md。Gemini CLI 读取 GEMINI.md，可通过 context.fileName 指向 AGENTS.md。GitHub Copilot 读取 .github/copilot-instructions.md、.github/instructions/*.instructions.md 和 AGENTS.md。Cline 读取 .clinerules/，也会识别 .cursorrules、.windsurfrules 和 AGENTS.md。在仓库根目录放一个 AGENTS.md 即可覆盖大多数 agent。

Claude Code 使用 ~/.claude/settings.json，以及项目中的 .claude/settings.json 和 .claude/settings.local.json。Codex 使用 ~/.codex/config.toml，以及受信任项目中的 .codex/config.toml。Gemini CLI 和 Qwen Code 使用 ~/.gemini/settings.json 和 ~/.qwen/settings.json，每个项目各有一个 .gemini 或 .qwen 文件夹。OpenCode 使用 ~/.config/opencode/opencode.json 和 opencode.json，Amp 使用 ~/.config/amp/settings.json 和 .amp/settings.json，Factory Droid 使用 ~/.factory/settings.json。Cursor 把 AI 设置放在 Cursor Settings 面板中，permissions.json 等 agent 文件放在 ~/.cursor 和 .cursor。在所有工具中，项目文件都会覆盖用户文件。

大多数 agent 读取一个包含 mcpServers 对象的 JSON 文件：Cursor 是 .cursor/mcp.json，Claude Code 是 .mcp.json，Kiro 是 .kiro/settings/mcp.json，Factory Droid 是 .factory/mcp.json，Junie 是 .junie/mcp/mcp.json。例外情况：VS Code（.vscode/mcp.json 中的 servers 键）、Codex（~/.codex/config.toml 中的 [mcp_servers.NAME] 表）、OpenCode（opencode.json 中的 mcp 键）、Zed（设置中的 context_servers）和 goose（config.yaml 中的 extensions）。Claude Code、Codex、Gemini CLI、Amp 和 Factory Droid 还提供 mcp add 命令。

Claude Code 读取 .claude/settings.json 中的 hooks 块，Gemini CLI 读取 .gemini/settings.json 中的 hooks 块，Cursor 读取 .cursor/hooks.json，Factory Droid 读取 .factory/hooks.json，GitHub Copilot 读取 .github/hooks/*.json，Kiro 读取 .kiro/hooks/ 中的任意 JSON 文件。它们都会通过 stdin 以 JSON 形式把事件发送给你的脚本。要阻止工具调用，在 Claude Code、Cursor、Gemini CLI、Factory Droid 和 Kiro CLI 中以退出码 2 退出，或以 JSON 输出 deny 决定（Copilot 使用 permissionDecision，Cursor 使用 permission）。

这些 agent 都会读取一个包含 SKILL.md 文件的文件夹，该文件的 YAML frontmatter 包含 name 和 description。Claude Code 使用 .claude/skills/ 和 ~/.claude/skills/。Codex、Amp 和 OpenHands 在仓库中使用 .agents/skills/，个人使用 ~/.agents/skills/。Cline 使用 .cline/skills/ 和 ~/.cline/skills/，也会读取 .claude/skills/。Amp 也会读取 .claude/skills/。因此，放在 .agents/skills/ 中的 skill 覆盖 Codex、Amp 和 OpenHands，在 .claude/skills/ 中放一份副本则覆盖 Claude Code、Cline 和 Amp。

Claude Code 会将每次工具调用与设置文件中的权限规则进行比对。规则写在 permissions.allow、permissions.ask 和 permissions.deny 中，格式为 Tool 或 Tool(specifier)，评估顺序为先 deny，再 ask，最后 allow。使用 /permissions 可查看所有规则及其来源文件，也可以传入 --allowedTools 和 --disallowedTools 仅对单次会话生效。

按 Shift+Tab 循环切换权限模式，使用 claude --permission-mode <mode> 启动，或在 .claude/settings.json 中用 permissions.allow 规则（如 Bash(npm run *)）预先批准特定命令。Auto 模式在运行时没有常规提示，由分类器审查操作；--dangerously-skip-permissions 仅适用于容器或虚拟机。

打开 Settings > Agents > Approvals & Execution 并选择一个 Run Mode。Run Everything 会自动运行每次工具调用，没有 sandbox 或审查；Allowlist 只运行你列出的命令；Auto-review 会立即运行 allowlist 中的调用，并在可能时将其他 shell 命令送入 sandbox。

在仓库的 .cursor/rules 文件夹中创建 .mdc 文件，每个文件都带有设置 description、globs 和 alwaysApply 的 frontmatter。最快的方法是在 Agent 聊天中输入 /create-rule。如果只需要不带元数据的纯 markdown，请改用 AGENTS.md 文件。

对于远程服务器，运行 claude mcp add --transport http NAME URL；对于本地 stdio 服务器，运行 claude mcp add [options] NAME -- COMMAND [args]。服务器默认保存在 local 作用域，因此只有你能看到，且仅限当前项目。使用 --scope project 写入共享的 .mcp.json，或使用 --scope user 让服务器在你的所有项目中可用。

这五个工具都允许你在文件中定义自定义 agent。Claude Code、Cursor、Gemini CLI 和 Copilot 使用带 YAML frontmatter 的 Markdown。Codex 使用独立的 TOML 文件。每个工具都内置了 subagent，例如 Claude Code 的 Explore、Codex 的 explorer、Cursor 和 Copilot 的 explore，以及 Gemini CLI 的 codebase_investigator。Claude Code、Cursor、Gemini CLI 和 Copilot 可以根据 agent 的 description 自行选择 agent。在 Codex 中，你需要直接请求 subagent，或由 AGENTS.md 或 skill 指令请求。这些工具差异最大的地方在于工具限制、模型选择以及后台或并行运行的方式。