diff --git a/codex-rs/core/config.schema.json b/codex-rs/core/config.schema.json
index 7a1c40a0a..c9da5c688 100644
--- a/codex-rs/core/config.schema.json
+++ b/codex-rs/core/config.schema.json
@@ -233,6 +233,9 @@
             "memory_tool": {
               "type": "boolean"
             },
+            "multi_agent": {
+              "type": "boolean"
+            },
             "personality": {
               "type": "boolean"
             },
@@ -1363,6 +1366,9 @@
         "memory_tool": {
           "type": "boolean"
         },
+        "multi_agent": {
+          "type": "boolean"
+        },
         "personality": {
           "type": "boolean"
         },
diff --git a/codex-rs/core/src/features.rs b/codex-rs/core/src/features.rs
index 33801c47c..00e38223b 100644
--- a/codex-rs/core/src/features.rs
+++ b/codex-rs/core/src/features.rs
@@ -552,7 +552,7 @@ pub const FEATURES: &[FeatureSpec] = &[
     },
     FeatureSpec {
         id: Feature::Collab,
-        key: "collab",
+        key: "multi_agent",
         stage: Stage::Experimental {
             name: "Sub-agents",
             menu_description: "Ask Codex to spawn multiple agents to parallelize the work and win in efficiency.",
@@ -738,4 +738,10 @@ mod tests {
         );
         assert_eq!(Feature::UseLinuxSandboxBwrap.default_enabled(), false);
     }
+
+    #[test]
+    fn collab_is_legacy_alias_for_multi_agent() {
+        assert_eq!(feature_for_key("multi_agent"), Some(Feature::Collab));
+        assert_eq!(feature_for_key("collab"), Some(Feature::Collab));
+    }
 }
diff --git a/codex-rs/core/src/features/legacy.rs b/codex-rs/core/src/features/legacy.rs
index 0c0f75714..41eab93bd 100644
--- a/codex-rs/core/src/features/legacy.rs
+++ b/codex-rs/core/src/features/legacy.rs
@@ -33,6 +33,10 @@ const ALIASES: &[Alias] = &[
         legacy_key: "web_search",
         feature: Feature::WebSearchRequest,
     },
+    Alias {
+        legacy_key: "collab",
+        feature: Feature::Collab,
+    },
 ];
 
 pub(crate) fn legacy_feature_keys() -> impl Iterator<Item = &'static str> {