diff --git a/codex-rs/app-server/tests/suite/v2/hooks_list.rs b/codex-rs/app-server/tests/suite/v2/hooks_list.rs
index 87f4decc2..f80d59d96 100644
--- a/codex-rs/app-server/tests/suite/v2/hooks_list.rs
+++ b/codex-rs/app-server/tests/suite/v2/hooks_list.rs
@@ -63,7 +63,7 @@ fn write_plugin_hook_config(codex_home: &std::path::Path, hooks_json: &str) -> R
         r#"[features]
 plugins = true
 plugin_hooks = true
-codex_hooks = true
+hooks = true
 
 [plugins."demo@test"]
 enabled = true
@@ -230,7 +230,7 @@ async fn hooks_list_uses_each_cwds_effective_feature_enablement() -> Result<()>
     std::fs::write(
         codex_home.path().join("config.toml"),
         r#"[features]
-codex_hooks = false
+hooks = false
 "#,
     )?;
     std::fs::create_dir_all(workspace.path().join(".git"))?;
@@ -238,7 +238,7 @@ codex_hooks = false
     std::fs::write(
         workspace.path().join(".codex/config.toml"),
         r#"[features]
-codex_hooks = true
+hooks = true
 
 [hooks]
 
diff --git a/codex-rs/core/config.schema.json b/codex-rs/core/config.schema.json
index 4d9e3d2d2..d7b7bba6a 100644
--- a/codex-rs/core/config.schema.json
+++ b/codex-rs/core/config.schema.json
@@ -448,6 +448,9 @@
             "guardian_approval": {
               "type": "boolean"
             },
+            "hooks": {
+              "type": "boolean"
+            },
             "image_detail_original": {
               "type": "boolean"
             },
@@ -3859,6 +3862,9 @@
         "guardian_approval": {
           "type": "boolean"
         },
+        "hooks": {
+          "type": "boolean"
+        },
         "image_detail_original": {
           "type": "boolean"
         },
diff --git a/codex-rs/core/tests/suite/hooks.rs b/codex-rs/core/tests/suite/hooks.rs
index daf3053ad..695e908ed 100644
--- a/codex-rs/core/tests/suite/hooks.rs
+++ b/codex-rs/core/tests/suite/hooks.rs
@@ -315,7 +315,7 @@ elif mode == "exit_2":
         .unwrap_or_default();
     let config_toml = format!(
         r#"[features]
-codex_hooks = true
+hooks = true
 
 [hooks]
 
diff --git a/codex-rs/features/src/legacy.rs b/codex-rs/features/src/legacy.rs
index 0dfaf0b1c..e87f14f59 100644
--- a/codex-rs/features/src/legacy.rs
+++ b/codex-rs/features/src/legacy.rs
@@ -49,6 +49,10 @@ const ALIASES: &[Alias] = &[
         legacy_key: "telepathy",
         feature: Feature::Chronicle,
     },
+    Alias {
+        legacy_key: "codex_hooks",
+        feature: Feature::CodexHooks,
+    },
 ];
 
 pub fn legacy_feature_keys() -> impl Iterator<Item = &'static str> {
diff --git a/codex-rs/features/src/lib.rs b/codex-rs/features/src/lib.rs
index 5c2a76eb8..04c3f4921 100644
--- a/codex-rs/features/src/lib.rs
+++ b/codex-rs/features/src/lib.rs
@@ -782,7 +782,7 @@ pub const FEATURES: &[FeatureSpec] = &[
     },
     FeatureSpec {
         id: Feature::CodexHooks,
-        key: "codex_hooks",
+        key: "hooks",
         stage: Stage::Stable,
         default_enabled: true,
     },
diff --git a/codex-rs/features/src/tests.rs b/codex-rs/features/src/tests.rs
index d1c0ae0c5..cb6310e08 100644
--- a/codex-rs/features/src/tests.rs
+++ b/codex-rs/features/src/tests.rs
@@ -267,6 +267,12 @@ fn collab_is_legacy_alias_for_multi_agent() {
     assert_eq!(feature_for_key("collab"), Some(Feature::Collab));
 }
 
+#[test]
+fn codex_hooks_is_legacy_alias_for_hooks() {
+    assert_eq!(feature_for_key("hooks"), Some(Feature::CodexHooks));
+    assert_eq!(feature_for_key("codex_hooks"), Some(Feature::CodexHooks));
+}
+
 #[test]
 fn multi_agent_is_stable_and_enabled_by_default() {
     assert_eq!(Feature::Collab.stage(), Stage::Stable);