Claude Code configuration

15-01-2026

• https://code.claude.com/docs/en/terminal-config#iterm-2-system-notifications
• https://matsen.fhcrc.org/general/2025/10/30/agentic-coding-principles.html
• https://github.com/wshobson/agents
• https://www.aihero.dev/my-agents-md-file-for-building-plans-you-actually-read
• https://github.com/karpathy/llm-council/blob/master/CLAUDE.md

Settings:

• C:\Users\lmiloszewski\.claude

Telemetry:

• https://code.claude.com/docs/en/monitoring-usage
• https://www.reddit.com/r/ClaudeCode/comments/1pjon1r/til_that_claude_code_has_opentelemetry_metrics/
• claude code to langsmith - https://docs.langchain.com/langsmith/trace-claude-code

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_METRICS_EXPORTER=otlp
export OTEL_TRACES_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=https://logfire-eu.pydantic.dev
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer LOGFIRE_WRITE_TOKEN"

Notifications:

• burnt toast
  • https://www.reddit.com/r/ClaudeAI/comments/1lcmyve/claude_code_in_windows_how_to_create_a_sound/

Hooks:

Tracing:

• intercepting network traffic using mitmproxy
  • https://github.com/mitmproxy/mitmproxy
  • requires administrator access
    • Open Settings
    • Go to Network & Internet → Proxy
    • Select “Manual proxy setup”
      • Turn ON “Use a proxy server”
      • Address: localhost
      • Port: 8080
    • Open Chrome and go to http://mitm.it

docker pull mitmproxy/mitmproxy:dev
 
# this makes :8081 accessible to the local machine only
docker run --rm -it -p 8080:8080 -p 127.0.0.1:8081:8081 mitmproxy/mitmproxy mitmweb --web-host 0.0.0.0
 
Web server listening at http://0.0.0.0:8081/
No web browser found. Please open a browser and point it to http://0.0.0.0:8081/
Proxy server listening at http://*:8080
[...]

• packet analyzer using tcpdump

  • https://www.tcpdump.org/

• claude-code-log

  • https://github.com/daaain/claude-code-log
  • takes existing history and visualises

• claude-telemetry

  • https://github.com/TechNickAI/claude_telemetry
  • a thin wrapper that runs the cc agent sdk with otel collection
    • https://platform.claude.com/docs/en/agent-sdk/overview
  • usage switches from claude to claudia

uv add "claude_telemetry[logfire]"

from claude_telemetry import run_agent_with_telemetry
 
await run_agent_with_telemetry(
    prompt="Analyze my project and suggest improvements",
)

• claude-trace
  • monkey patches global.fetch and the Node HTTP library, then runs Claude Code using Node with an extra --require interceptor-loader.js option to inject the patches
  • https://simonwillison.net/2025/Jun/2/claude-trace/
  • https://github.com/badlogic/lemmy/tree/main/apps/claude-trace

npx @mariozechner/claude-trace --include-all-requests

• cchistory
  • https://mariozechner.at/posts/2025-08-03-cchistory/
  • the system prompts and tools are baked into each CC version binary, so you can download each version, run the trace, and see what has changed at each iteration