Skip to content

Commit 36457b7

Browse files
lroolleclaude
andcommitted
docs: add Request Tracing section for --trace/cctrace
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 7d5dc12 commit 36457b7

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

docs/advanced-usage.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,22 @@ Use them in that order:
160160

161161
The printed `docker run` line is diagnostic output. It masks secrets and may contain unquoted values. Read it. Do not blindly paste it back into a shell and then complain when your shell parses spaces like spaces.
162162

163+
## Request Tracing
164+
165+
```bash
166+
deva.sh claude -- --trace --continue
167+
```
168+
169+
`--trace` wraps Claude with [cctrace](https://github.com/thevibeworks/cctrace),
170+
which records every API call Claude makes — messages, OAuth, usage/credits,
171+
MCP — not just the chat endpoint. Everything else on the line goes to Claude
172+
unchanged.
173+
174+
Traces land in `.cctrace/` inside your workspace, so they survive the
175+
container. Each run writes a JSONL log plus a self-contained HTML snapshot you
176+
can open in a browser on the host. Credentials are redacted before anything
177+
hits disk.
178+
163179
## Risk Knobs
164180

165181
### Docker Socket

0 commit comments

Comments
 (0)