diff --git a/README.md b/README.md
index fe3db3e71..42b8556b2 100644
--- a/README.md
+++ b/README.md
@@ -187,7 +187,20 @@ MiMoCode is configured via `.mimocode/mimocode.json` in the project directory (o
 - MCP server connections
 - Keybindings and theme
 
-Max Mode (parallel best-of-N reasoning with judge selection) can be enabled via `experimental.maxMode` in the config.
+#### Max Mode
+
+Enable by adding `experimental.maxMode` to your config:
+
+```jsonc
+{
+  "experimental": {
+    "maxMode": {}            // default: 5 parallel candidates per step
+    // "maxMode": { "candidates": 3 }  // custom candidate count
+  }
+}
+```
+
+A new **max** agent appears — press `Tab` to switch to it. Same permissions as **build**. Each step costs roughly `candidates ×` normal tokens.
 
 ---
 
diff --git a/README.zh.md b/README.zh.md
index d133c5412..78fb0ffae 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -187,7 +187,20 @@ export PULSE_SERVER=tcp:127.0.0.1:4713
 - MCP 服务器连接
 - 快捷键和主题
 
-Max Mode（并行 best-of-N 推理 + 裁判选优）可通过配置中的 `experimental.maxMode` 开启。
+#### Max Mode
+
+在配置中添加 `experimental.maxMode` 开启：
+
+```jsonc
+{
+  "experimental": {
+    "maxMode": {}            // 默认：每步 5 个并行候选
+    // "maxMode": { "candidates": 3 }  // 自定义候选数量
+  }
+}
+```
+
+开启后智能体列表出现 **max**，按 `Tab` 切换。权限与 **build** 相同，每步消耗约为 `candidates ×` 倍。
 
 ---