Docs search: debug / page 2 of 5 / Source Intelligence

Streaming Input Claude Code CLI · in the page agent-sdk/streaming-vs-single-mode …error text. > > In the Python SDK, a generator exception is logged at debug level and the session stalls without raising, so if a streaming session hangs with no output, enable debug logging and check…

Get structured output from agents Claude Code CLI · in the page agent-sdk/structured-outputs …list on the error result message to tell the two causes apart before debugging your schema. When an error occurs, the result message has a `subtype` indicating what went wrong: | Subtype | Meaning…

Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …ates can each own a separate piece without stepping on each other * **Debugging with competing hypotheses**: teammates test different theories in parallel and converge on the answer faster * **Cross-l…

Manage multiple agents with agent view Claude Code CLI · in the page agent-view …move hook failed)` or git's error, the hook's stderr went only to the debug log, and deleting again was refused the same way. | | v2.1.268 | After the first `←` shows `Press ← again to open agents`, o…

Best practices for Claude Code Claude Code CLI · in the page best-practices …s, and every command output. However, this can fill up fast. A single debugging session or codebase exploration might generate and consume tens of thousands of tokens. This matters since LLM performa…

Claude Code changelog Claude Code CLI · in the page changelog …rtup warnings printing as raw text above the logo: they now go to the debug log, and permission rules that restrict nothing show as warning rows under the banner * Fixed screen reader mode: search box…

Push events into a running session with channels Claude Code CLI · in the page channels …where Claude already has your files open and remembers what you were debugging. ## Next steps Once you have a channel running, explore these related features: * [Build your own channel](/docs/en/c…

Channels reference Claude Code CLI · in the page channels-reference …in your server file. To see the stderr trace, restart with `claude --debug --dangerously-load-development-channels server:webhook` and check the debug log at `~/.claude/debug/<session-id>.txt`. * **`…

Checkpointing Claude Code CLI · in the page checkpointing …rt to working states * **Freeing context space**: summarize a verbose debugging session from the midpoint forward, keeping your initial instructions intact ## Limitations ### Bash command changes no…

Use Claude Code with Chrome Claude Code CLI · in the page chrome …hrome > Connect Claude Code to your Chrome browser to test web apps, debug with console logs, automate form filling, and extract data from web pages. Claude Code integrates with the [Claude in Chrom…

Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …is controlled by the CLAUDE_GATEWAY_LOG_LEVEL # environment variable (debug | info | warn | error; default info). debug # also logs the claim names in each id_token, for groups_claim diagnosis. # It d…

Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …TEWAY_LOG_LEVEL` environment variable controls verbosity and accepts `debug`, `info`, `warn`, or `error`, with `info` as the default. At `debug`, each sign-in and refresh also logs the names, not the…

Explore the .claude directory Claude Code CLI · in the page claude-directory …you writing anything. Claude saves notes as it works: build commands, debugging insights, architecture notes. Each project gets its own memory directory keyed by the repository path.', tips:…

CLI reference Claude Code CLI · in the page cli-reference …e all local Claude Code state for a project: transcripts, task lists, debug logs, file-edit history, prompt history lines, and the project's entry in `~/.claude.json`. Omit `[path]` to pick from an in…

Configure cloud environments Claude Code CLI · in the page cloud-environments …three variables. ```text theme={null} NODE_ENV=development LOG_LEVEL=debug DATABASE_URL=postgres://localhost:5432/myapp ``` A session reads the environment's values into ordinary environment variabl…

Commands Claude Code CLI · in the page commands …t diagnoses installation and configuration issues and can fix them, `/debug` diagnoses runtime issues, and `/feedback` reports a bug with session context attached. ## All commands The table below li…

Common workflows Claude Code CLI · in the page common-workflows …re prompt patterns for everyday tasks like exploring unfamiliar code, debugging, refactoring, writing tests, and creating PRs. Each works in any Claude Code surface; adapt the wording to your project.…

Communications kit Claude Code CLI · in the page communications-kit …reads your actual codebase, and works through real tasks end to end: debugging, refactors, tests, PRs. It is not autocomplete and it is not a chat window. It edits files and runs your commands. Get…

Let Claude use your computer from the CLI Claude Code CLI · in the page computer-use …en apps, click, type, and see your screen on macOS. Test native apps, debug visual issues, and automate GUI-only tools without leaving your terminal. > [!NOTE] > > Computer use is a research preview…

Explore the context window Claude Code CLI · in the page context-window …ude\'s context. Plain stdout on exit 0 does not. It is written to the debug log only.', tip: 'Output JSON with `additionalContext` to send info to Claude. For PostToolUse hooks, exit code 2 surfac…

Run Claude Code behind a corporate launcher Claude Code CLI · in the page corporate-launcher …unwrapped and keeps working, and the only signal is a warning in the [debug log](/docs/en/troubleshooting.md). If your launcher policy covers Windows, the variable doesn't satisfy it there: count Wind…

Manage costs effectively Claude Code CLI · in the page costs …n carries file contents, tool calls, and multi-step reasoning, so one debugging session can consume more than a day of chat. ### Claude Console API organizations manage Claude Code spend through [wo…

Message your other Claude Code sessions Claude Code CLI · in the page cross-session-messaging …s `unavailable` and the reason in its `Peer address` row, and the [`--debug`](/docs/en/cli-reference#cli-flags) log records the full refusal. Alongside the socket's path, Claude Code exports a per-se…

Desktop application Claude Code CLI · in the page desktop …Claude's reasoning with tool calls still collapsed. Use Verbose when debugging why Claude took a particular action. Claude Desktop versions before 1.46388.1 also list a Summary mode, and a session st…

Get started with the desktop app Claude Code CLI · in the page desktop-quickstart …ode * [Common workflows](/docs/en/common-workflows.md): tutorials for debugging, refactoring, testing, and more

Environment variables Claude Code CLI · in the page env-vars …| | `CLAUDE_CODE_DEBUG_LOGS_DIR` | Override the debug log file path. Despite the name, this is a file path, not a direct…

Error reference Claude Code CLI · in the page errors …red) | | `Marketplace "<name>" is registered but was refused (see the debug log)` | [Plugin troubleshooting](/docs/en/plugins/troubleshooting.md#marketplace-is-added-but-ignored) | | `references ${use…

Speed up responses with fast mode Claude Code CLI · in the page fast-mode …when you need speed for interactive work like rapid iteration or live debugging, and toggle it off when cost matters more than latency. Fast mode is not a different model. It uses Claude Opus with a…

Extend Claude Code Claude Code CLI · in the page features-overview …script. For example: a `/release` checklist, your API style guide, a debugging playbook. **Put guardrails in hooks.** An instruction like "never edit `.env`" in CLAUDE.md or a skill is a request, no…

Claude Code GitHub Actions Claude Code CLI · in the page github-actions …ey or OAuth token is valid by testing it locally with `claude` before debugging the workflow * For Bedrock, Agent Platform, and Foundry, see the cloud provider page's [troubleshooting section](/docs/e…

Claude Code GitLab CI/CD Claude Code CLI · in the page gitlab-ci-cd …Edits --allowedTools "Bash Read Edit Write mcp__gitlab" --debug ``` After adding the job and your `ANTHROPIC_API_KEY` variable, test by running the job manually from **CI/CD** → **Pipelin…

Glossary Claude Code CLI · in the page glossary …ybooks included with Claude Code, such as `/batch`, `/code-review`, `/debug`, and `/loop`. Unlike built-in commands, which execute fixed logic, bundled skills give Claude a detailed prompt and let it…

Set up Claude Code (local mode) for a HIPAA-ready organization Claude Code CLI · in the page hipaa-setup …very project's transcripts and auto memory, the entries in `tasks/`, `debug/`, and `file-history/`, `history.jsonl`, and the project entries in `~/.claude.json`. Without `--yes`, it prints the plan an…

Hooks reference Claude Code CLI · in the page hooks …. Claude Code records a warning naming the fallback directory in the [debug log](#debug-hooks). For a worktree session that you start from the desktop app, see [What worktrees share with the main chec…

Automate actions with hooks Claude Code CLI · in the page hooks-guide …with non-blocking status code:`. To capture the full stderr, enable [debug logging](/docs/en/hooks.md#debug-hooks) with `claude --debug` or by running `/debug` mid-session. #### Structured JSON outp…

Interactive mode Claude Code CLI · in the page interactive-mode …e for at least 30 minutes and no turn or subagent is running * The [debug log](/docs/en/debug-your-config.md) says why tasks were stopped, or why a pressure event left them running * Set [`CLAUDE_…

Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …hen it doesn't supply one. To confirm discovery ran, start `claude --debug` and look for the `[gatewayDiscovery]` lines in the debug log at `~/.claude/debug/<session-id>.txt`. The first time discover…

Claude Code gateway compatibility guide Claude Code CLI · in the page llm-gateway-protocol …skips discovery and writes a `[gatewayDiscovery] skipped` line to the debug log of a `claude --debug` session. If you supply a credential only through `ANTHROPIC_CUSTOM_HEADERS`, Claude Code still ski…

Control MCP server access for your organization Claude Code CLI · in the page managed-mcp …n a warning on its stderr, which a self-hosted runner records at the `debug` log level. The `--strict-mcp-config` flag asks to replace the managed set. If a user passes it while such a file is deploy…

Deploy managed settings Claude Code CLI · in the page managed-settings …. This page is for the administrator who deploys managed settings or debugs why one isn't applying. To decide what to enforce, start with the [Decide what to enforce](/docs/en/admin-setup.md#decide-w…

Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …references a covered variable you have set, Claude Code names it in a debug-log line. To read the line, run `claude --debug-file /tmp/claude-debug.log` and search that file for `never expanded toward…

How Claude remembers your project Claude Code CLI · in the page memory …frontmatter and loads the rule as if it had no `paths`. Run `claude --debug` to see the parse error. #### Share rules across projects with symlinks The `.claude/rules/` directory supports symlinks,…

Model configuration Claude Code CLI · in the page model-config …. * **Hand it ambiguous problems**: root-cause investigations, outage debugging, and architecture decisions are where the extra investigation and verification pay off. * **Skip the verification remind…

Monitoring Claude Code CLI · in the page monitoring-usage …TEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token" # 5. For debugging: reduce export intervals, and reset them for production use export OTEL_METRIC_EXPORT_INTERVAL=10000 # 10 seconds (defa…

Enterprise network configuration Claude Code CLI · in the page network-config …To confirm Claude Code picked up a rotation, [start the session with debug logging](#verify-your-configuration) and look for `Stale connection — reloaded rotated mTLS client material` in the log. Cla…