docs(spawn): document claudecode env sanitization behavior

- note delegation compatibility with Claude nested-session guard

- document CLAUDECODE sanitization invariant in code standards

Refs #588
This commit is contained in:
Tam Nhu Tran
2026-02-20 23:01:21 +07:00
parent 80a84edf1f
commit f2ffb815ab
2 changed files with 13 additions and 0 deletions
+9
View File
@@ -429,6 +429,15 @@ if (needsShell) {
This pattern is used in both `ClaudeAdapter` and `DroidAdapter` to ensure cross-platform consistency.
For all Claude child-process launches (delegation, adapters, proxies, helper spawners), sanitize env before spawn:
```typescript
const cleanEnv = stripClaudeCodeEnv(mergedEnv); // case-insensitive remove of CLAUDECODE
spawn(binaryPath, args, { env: cleanEnv, stdio: 'inherit' });
```
This prevents Claude Code nested-session guard failures when CCS runs inside parent Claude sessions.
---
## React Component Standards (UI)