Codex vs Claude Code /init 命令深度对比：两大 AI 编码助手的项目初始化设计差异

Wed, 27 May 2026 14:00:00 +0800

/init 命令是 AI 编码助手的核心功能之一，用于自动生成项目指南文档。本文深入对比 OpenAI Codex 和 Claude Code 的 /init 命令实现，揭示两者在设计理念、实现机制和用户体验上的显著差异。

1. 功能定位对比

1.1 OpenAI Codex `/init`

核心目标：生成项目贡献者指南（AGENTS.md）

1
2
3
4
5
6


// 检查目标文件是否存在
let init_target = self.config.cwd.join(DEFAULT_AGENTS_MD_FILENAME);
if init_target.exists() {
 // 安全退出，避免覆盖
 return;
}

1.2 Claude Code `/init`

核心目标：生成项目/个人配置文件（CLAUDE.md + CLAUDE.local.md）+ 技能 + Hooks

1
2
3
4
5
6


const command = {
 type: 'prompt',
 name: 'init',
 description: 'Initialize new CLAUDE.md file(s) and optional skills/hooks',
 // ...
}

功能范围对比

功能	Codex	Claude Code
生成项目指南	✅ AGENTS.md	✅ CLAUDE.md
个人配置	❌	✅ CLAUDE.local.md
技能系统	❌	✅ .claude/skills/
Hooks 系统	❌	✅ .claude/settings.json
文件覆盖保护	✅	✅

2. Codex `/init` 实现分析

2.1 完整调用链路

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


用户输入 `/init`
 │
 ▼
ChatComposer::parse_slash_command() → SlashCommand::Init
 │
 ▼
ChatWidget::handle_slash_command_dispatch()
 │
 ▼
ChatWidget::dispatch_command(SlashCommand::Init)
 │
 ├─ 检查: AGENTS.md 是否存在？
 │ ├─ YES → 显示提示并返回
 │ └─ NO ↓
 │
 ▼
加载 INIT_PROMPT (prompt_for_init_command.md)
 │
 ▼
submit_user_message(INIT_PROMPT)
 │
 ▼
Session → Turn → ModelClient → OpenAI API
 │
 ▼
模型生成内容 → write_to_file 工具调用
 │
 ▼
生成 ./AGENTS.md

2.2 核心代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


// tui/src/chatwidget/slash_dispatch.rs:176-187
SlashCommand::Init => {
 let init_target = self.config.cwd.join(DEFAULT_AGENTS_MD_FILENAME);
 if init_target.exists() {
 let message = format!(
 "{DEFAULT_AGENTS_MD_FILENAME} already exists here. Skipping /init."
 );
 self.add_info_message(message, /*hint*/ None);
 return;
 }
 const INIT_PROMPT: &str = include_str!("../../prompt_for_init_command.md");
 self.submit_user_message(INIT_PROMPT.to_string().into());
}

2.3 Prompt 设计

Codex 的 Prompt（约 500 词）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


Generate a file named AGENTS.md that serves as a contributor guide.

Document Requirements:
- Title: "Repository Guidelines"
- Length: 200-400 words
- Use Markdown headings

Recommended Sections:
1. Project Structure & Module Organization
2. Build, Test, and Development Commands
3. Coding Style & Naming Conventions
4. Testing Guidelines
5. Commit & Pull Request Guidelines

设计特点：

简洁明了，直接指定输出格式
固定的 5 个章节结构
长度限制确保输出精简
编译时嵌入（include_str!）

2.4 输出产物

生成的 AGENTS.md 结构：

1
2
3
4
5
6
7
8
9


# Repository Guidelines

## Project Structure & Module Organization
- src/ - 源代码
- tests/ - 测试代码

## Build, Test, and Development Commands
- `npm test` - 运行测试
- `npm run build` - 构建项目

3. Claude Code `/init` 实现分析

3.1 完整调用链路

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


用户输入 `/init`
 │
 ▼
SlashCommandParser → CommandRegistry.get('init')
 │
 ▼
CommandExecutor.execute(command)
 │
 ▼
getPromptForCommand() → 返回 Prompt 数组
 │
 ├─ NEW_INIT 特性启用?
 │ ├─ YES → NEW_INIT_PROMPT (225 行)
 │ └─ NO → OLD_INIT_PROMPT (20 行)
 │
 ▼
Agent 执行 8 阶段流程
 │
 ├─ Phase 1: 询问用户需求
 ├─ Phase 2: 探索代码库
 ├─ Phase 3: 填补信息 gaps
 ├─ Phase 4: 写入 CLAUDE.md
 ├─ Phase 5: 写入 CLAUDE.local.md (可选)
 ├─ Phase 6: 创建技能 (可选)
 ├─ Phase 7: 建议优化 (可选)
 └─ Phase 8: 总结

3.2 核心代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


// src/commands/init.ts:226-254
const command = {
 type: 'prompt',
 name: 'init',
 get description() {
 return feature('NEW_INIT') &&
 (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
 ? 'Initialize new CLAUDE.md file(s) and optional skills/hooks'
 : 'Initialize a new CLAUDE.md file'
 },
 contentLength: 0,
 progressMessage: 'analyzing your codebase',
 source: 'builtin',
 async getPromptForCommand() {
 maybeMarkProjectOnboardingComplete()
 return [{
 type: 'text',
 text: feature('NEW_INIT') &&
 (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
 ? NEW_INIT_PROMPT
 : OLD_INIT_PROMPT,
 }]
 },
}

3.3 Prompt 设计

Claude Code 的 NEW_INIT_PROMPT（约 225 行，分 8 个阶段）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


## Phase 1: Ask what to set up

Use AskUserQuestion to find out:
- "Which CLAUDE.md files should /init set up?"
 Options: "Project CLAUDE.md" | "Personal CLAUDE.local.md" | "Both"

- "Also set up skills and hooks?"
 Options: "Skills + hooks" | "Skills only" | "Hooks only" | "Neither"

## Phase 2: Explore the codebase

Launch a subagent to survey:
- manifest files (package.json, Cargo.toml, etc.)
- README, Makefile, CI config
- existing CLAUDE.md, .cursor/rules, AGENTS.md
- Formatter configuration

## Phase 3: Fill in the gaps

Ask about:
- Codebase practices (non-obvious commands, gotchas)
- Personal preferences (role, familiarity, sandbox URLs)

## Phase 4: Write CLAUDE.md

Include only what Claude would get wrong without it:
- Build/test/lint commands that can't be guessed
- Code style rules that differ from defaults
- Non-obvious gotchas

## Phase 5: Write CLAUDE.local.md (if chosen)

Include personal preferences, sandbox URLs, communication style.

## Phase 6: Create skills

Name: verify-deep, session-report, deploy-sandbox
Location: .claude/skills/<skill-name>/SKILL.md

## Phase 7: Suggest hooks

- Format-on-edit hook
- Pre-commit hook

## Phase 8: Summary and next steps

设计特点：

交互式：多轮对话询问用户偏好
分阶段：8 个明确的执行阶段
可配置：用户选择要创建的内容类型
增量更新：不覆盖现有文件，只建议修改

3.4 输出产物

生成的文件结构：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


./
├── CLAUDE.md # 团队共享的项目指南
├── CLAUDE.local.md # 个人配置（gitignored）
├── .claude/
│ ├── skills/
│ │ ├── verify/
│ │ │ └── SKILL.md
│ │ └── deploy/
│ │ └── SKILL.md
│ └── settings.json # Hooks 配置
└── .gitignore # 更新以包含 CLAUDE.local.md

4. 核心设计差异对比

4.1 设计理念差异

维度	Codex	Claude Code
哲学	简单直接	高度可配置
交互模式	一键生成	多轮对话
输出范围	单一文件	多文件 + 技能 + Hooks
用户控制	无选项	丰富的配置选项
复杂度	低	高

4.2 Prompt 设计对比

维度	Codex	Claude Code
长度	~500 词	~8000 词
结构	线性指令	8 阶段工作流
交互	无	多轮 AskUserQuestion
灵活性	固定格式	可配置输出
复杂度	低	高

4.3 执行流程对比

1
2
3
4
5
6
7


Codex:
 用户输入 → 检查文件 → 提交 Prompt → 模型生成 → 写入文件

Claude Code:
 用户输入 → 询问需求 → 探索代码库 → 询问补充信息
 → 生成提案 → 用户确认 → 写入多个文件
 → 创建技能 → 建议优化 → 总结

4.4 安全保护对比

机制	Codex	Claude Code
文件存在检查	✅	✅
增量更新	❌ (跳过)	✅ (建议修改)
预览机制	❌	✅ (提案预览)
用户确认	❌	✅ (多轮确认)

4.5 扩展性对比

扩展能力	Codex	Claude Code
技能系统	❌	✅
Hooks 系统	❌	✅
个人配置	❌	✅
插件支持	❌	✅
模块化配置	❌	✅ (.claude/rules/)

5. 技术实现细节对比

5.1 命令注册

Codex（Rust 枚举）：

1
2
3
4
5
6
7


pub enum SlashCommand {
 Feedback,
 New,
 Init, // 内置命令
 Compact,
 // ...
}

Claude Code（TypeScript 对象）：

1
2
3
4
5
6


const command = {
 type: 'prompt',
 name: 'init',
 description: 'Initialize project',
 async getPromptForCommand() { /* ... */ },
} satisfies Command

5.2 Prompt 加载方式

Codex：编译时嵌入

1

const INIT_PROMPT: &str = include_str!("../../prompt_for_init_command.md");

Claude Code：运行时返回

1
2
3


async getPromptForCommand() {
 return [{ type: 'text', text: NEW_INIT_PROMPT }]
}

5.3 特性开关

Claude Code 使用特性标志控制新旧版本：

1
2
3
4


feature('NEW_INIT') &&
 (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
 ? NEW_INIT_PROMPT
 : OLD_INIT_PROMPT

6. 用户体验对比

6.1 首次使用

Codex：

1
2
3


> /init
[分析代码库...]
AGENTS.md 已创建

Claude Code：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


> /init
我来帮你初始化这个项目。

1. 你想要创建哪些文件？
 - Project CLAUDE.md
 - Personal CLAUDE.local.md
 - Both project + personal

2. 还要设置技能和 hooks 吗？
 - Skills + hooks
 - Skills only
 - Hooks only
 - Neither, just CLAUDE.md

[用户选择后...]

让我先探索一下代码库...

[分析完成后...]

我发现了这些信息：
- 项目类型：TypeScript + React
- 构建工具：npm
- 测试框架：Jest

[询问补充信息...]

[生成提案...]

这个提案看起来对吗？
- • Format-on-edit hook — ruff format <file>
- • /verify skill — npm test
- • CLAUDE.md note — "run tests before PR"

[用户确认后...]

CLAUDE.md 已创建
CLAUDE.local.md 已创建
技能 /verify 已创建
Hooks 已配置

6.2 现有项目