diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/claude_code_cli.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/claude_code_cli.rs
index 88e86b811..8029bb358 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/claude_code_cli.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/claude_code_cli.rs
@@ -15,6 +15,9 @@ use tokio::io::{AsyncBufReadExt, AsyncReadExt, AsyncWriteExt, BufReader};
 
 const CLAUDE_AGENT_SIDECAR_ENV: &str = "GENARRATIVE_CLAUDE_AGENT_SIDECAR";
 const CLAUDE_NODE_ENV: &str = "GENARRATIVE_CLAUDE_NODE";
+/// DirectProject 的一次 CC 回合可能包含代码生成、试玩、修复和再次复核；8 次会在真实
+/// 游戏链路的修复阶段提前收口成 `Reached maximum number of turns (8)`。
+const CLAUDE_DIRECT_MAX_TURNS: u32 = 16;
 const CLAUDE_CODE_OUTPUT_MAX_BYTES: usize = 8 * 1024 * 1024;
 const CLAUDE_CODE_PROMPT_MAX_BYTES: usize = 4 * 1024 * 1024;
 const CLAUDE_CODE_MODEL_MAX_CHARS: usize = 200;
@@ -1760,7 +1763,7 @@ pub(crate) async fn direct_game_creator_claude_code_chat_at(
         "systemPrompt": system_prompt,
         "cwd": root,
         "model": llm.model.trim(),
-        "maxTurns": 8,
+        "maxTurns": CLAUDE_DIRECT_MAX_TURNS,
         "mcpServers": {
             "agc": {
                 "type": "http",
diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
index e2fb93655..458f69d5f 100644
--- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
@@ -1,5 +1,11 @@
 # AI 游戏创作智能体 App 实施计划
 
+## 2026-10-06 真实客户端做游戏链路复核：CC 回合上限
+
+真实客户端项目 `gameagent-9f80d315` 的运行证据显示，CC 已完成代码写入并进入真实浏览器试玩；试玩发现问题后，修复回合以 `Claude Code 返回失败终态：Reached maximum number of turns (8)` 收口，导致生成链路无法登记完成版本。该错误来自 `direct_game_creator_claude_code_chat_at` 发送给 Claude Agent SDK sidecar 的固定 `maxTurns=8`，不是前端错误兜底。
+
+DirectProject 一次用户回合允许“生成 → 真实试玩 → 修复 → 再试玩 → 登记”的连续 CC 调用，sidecar 单次上限调整为 16；失败正文继续沿用现有脱敏与 `turn.completed.failure` 合同。定向证据：`cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --offline claude_failure_reuses_codex_error_categories -- --nocapture` 通过；需要重新从真实客户端发送做游戏请求，才能确认新的上限足够覆盖当前 Provider 的修复步数。
+
 ## 2026-10-04 Codex 与 CC DirectProject 运行态事件统一
 
 ### 目标