Troubleshooting

Troubleshooting

A lane won't connect (App login)

Make sure the CLI is installed and logged in in your terminal first:

• Claude: claude installed, signed in.
• Codex: codex installed, codex login done. AgentStudio reuses that login. If the CLI isn't on PATH, the header shows 未安装 / not installed.

Connection drops every launch

Expected — connection state is session-scoped and not persisted, by design. Click Connect once; an existing CLI login is detected instantly.

Repeated "socket connection closed unexpectedly"

Usually a flaky local proxy. AgentStudio retries with exponential backoff, then surfaces a hint. Fixes: switch your proxy node, or set Settings → Proxy to a different mode/scope (e.g. None for a direct connection, or narrow the scope). See Settings and Proxy.

The model I picked is rejected

Pick from the dropdown where possible. For free-text fields, use an id the CLI accepts (claude --model …, codex -m …). Claude's [1m] suffix selects the 1M-context variant. Hit ⟳ to refresh the list after adding an API key. See Models.

API-key mode "isn't using my key"

Confirm the lane's method toggle is set to API Key (not App login) and a key is saved. Claude uses ANTHROPIC_API_KEY, Codex uses OPENAI_API_KEY. DeepSeek is always key-based.

Auto memory isn't appearing

• Check Settings → Memory → Auto memory is On.
• Auto memory is written after a conversation finishes (a Solo turn settling, or a Dual round completing) — not mid-turn.
• It needs a working backend to do the extraction; if the lane that just ran failed, extraction is skipped silently.
• Inspect/edit results in the Memory view (Auto tab). See Memory.

Does AgentStudio change my Codex / Claude memory?

No. Codex's memory features are disabled only for AgentStudio's own runs via launch flags — your ~/.codex/config.toml, the ~/.codex/memories store, and your terminal Codex are untouched. Claude's ~/.claude is never modified. See Memory → Isolation.

The built app won't open ("unidentified developer")

The self-built app is ad-hoc signed. Right-click → Open the first time, or set a Developer ID identity + notarization in studio/electron-builder.yml for distribution.

Where are my files / data?

• Your project changes happen inside the project folder you selected.
• Settings, history, and global memory live in the app's userData directory; project memory lives in <project>/.agentstudio/.