claude-code-agent/claude-code-agent.example.yaml at main · dwmkerr/claude-code-agent · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
# claude-code-agent configuration
#
# Configuration values can be set via (in order of precedence):
#   1. Command line arguments (highest priority)
#   2. Environment variables
#   3. This config file
#   4. Default values (lowest priority)
#
# Config file locations (first found is used):
#   1. Path specified by --config CLI argument
#   2. Path specified by CLAUDE_CODE_AGENT_CONFIG env var
#   3. ./.claude-code-agent.yaml (dotfile in current directory)
#
# Copy this file to .claude-code-agent.yaml and customize as needed.

# Server configuration
server:
  # Host to bind the server to
  # CLI: --host, -H
  # Env: HOST
  # Default: 0.0.0.0
  host: "0.0.0.0"

  # Port to listen on
  # CLI: --port, -p
  # Env: PORT
  # Default: 2222
  port: 2222

# Agent configuration
agent:
  # Agent name for A2A registration
  # CLI: --agent-name
  # Env: CLAUDE_AGENT_NAME
  # Default: claude-code
  name: "claude-code"

  # Workspace directory for Claude Code operations
  # CLI: --workspace, -w
  # Env: CLAUDE_CODE_WORKSPACE_DIR
  # Default: ./workspace (or /workspace in containers)
  workspace: "./workspace"

  # Execution timeout in seconds
  # CLI: --timeout
  # Env: CLAUDE_TIMEOUT_SECONDS
  # Default: 3600 (1 hour)
  timeout: 3600

  # Session initialization script
  # Runs when a new session starts to configure MCP servers, plugins, etc.
  # CLI: --init-session
  # Env: INIT_SESSION
  # Default: ./.init-session.sh (auto-detected if present)
  # initSession: "./.init-session.sh"

# Logging configuration
logging:
  # Path to write Claude output logs
  # CLI: --log-path
  # Env: CLAUDE_LOG_PATH
  # Default: null (no logging)
  path: null

# Claude Code passthrough arguments
# These args are passed directly to the Claude Code CLI after --
# CLI args (after --) are appended to config file args
# Default: [] (empty)
claudeArgs: []

# Example:
# claudeArgs:
#  - "--allowedTools"
#  - "Bash,Read"

# OpenTelemetry configuration
#
# There are two separate OTEL systems:
#
# 1. Claude Code's built-in telemetry (metrics/events):
#    Enable with CLAUDE_CODE_ENABLE_TELEMETRY=1
#    Exports metrics and events via standard OTEL protocol
#
# 2. Claude Code Agent span transformer (configured below):
#    Creates LLM and tool spans from Claude's JSON output
#    Useful for visualizing agentic loops in Phoenix/Jaeger
#
# Both use standard OTEL env vars for export configuration:
#
#   OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:6006
#   OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
#   OTEL_SERVICE_NAME=claude-code-agent
#
# You can set these in .env for convenience.
otel:
  tracing:
    # Enable tracing
    # Default: false
    enabled: false

    # Aggregate all spans into a single parent span per A2A message
    # When false (default), each LLM call and tool use creates independent spans
    # When true, creates a single trace with nested spans (waits for completion)
    # Default: false
    aggregateSpans: false

    # How to populate input.value attribute on spans
    # - "chained": Each span's input is the previous span's output (default)
    # - "full": Input is the complete conversation history (true LLM input)
    # Default: chained
    inputMode: "chained"