Claude的日志文件在哪里？

Claude日志文件定位指南：从配置到实战的完整路径解析

对于依赖Claude Code进行AI编程协作的开发者而言，日志文件是诊断API调用异常、模型路由错误及性能瓶颈的核心依据，本文基于Claude Code Router的日志架构与实际运维案例，系统梳理日志文件的存储路径、访问权限及分析方法。

Claude的日志文件在哪里？

日志文件存储路径与层级结构

Claude Code Router采用双层级日志架构，核心日志分为服务器级与应用级两类，存储路径因操作系统与部署方式而异：

Linux系统默认路径

服务器级日志（Pino格式）：
~/.claude-code-router/logs/ccr-*.log
该文件记录所有API调用的原始数据，包含时间戳、模型名称、状态码、响应时长等关键字段。
```
{
  "level": 30,
  "time": 1735736218000,
  "msg": "API call completed",
  "provider": "deepseek",
  "model": "deepseek-chat",
  "status": 200,
  "duration": 1250
}
```

应用级日志（自定义格式）：
~/.claude-code-router/claude-code-router.log
记录路由决策、模型切换及错误事件，

[2025-09-01T15:30:18.123Z] Router selected model: deepseek-chat for session: session-abc123
[2025-09-01T15:30:20.789Z] ERROR: API call to DeepSeek failed with status 503

Windows系统路径

日志文件存储于用户目录下的隐藏文件夹：
C:\Users\<用户名>\.claude-code-router\logs\
可通过资源管理器输入路径直接访问，或使用PowerShell命令：
```
Get-ChildItem -Path "$env:USERPROFILE\.claude-code-router\logs\" -Filter "ccr-*.log"
```

Docker容器部署路径

若通过Docker运行Claude Code Router，日志文件映射至宿主机的/var/log/claude/目录，需在docker-compose.yml中配置卷挂载：

volumes:
  - ./claude-logs:/var/log/claude

日志访问权限与安全控制

日志文件的访问权限受config.json中的LOG_LEVEL参数控制，默认仅允许配置文件所有者读写，若需开放权限，需修改配置并重启服务：

{
  "LOG": true,
  "LOG_LEVEL": "debug",  // 可选值：error/warn/info/debug
  "APIKEY": "your-secret-key"
}

权限提升风险：将LOG_LEVEL设为debug会记录敏感信息（如API密钥片段），建议仅在排查问题时临时启用。

日志分析实战：从定位到解决

实时监控API调用状态

使用tail -f命令跟踪服务器日志，结合jq过滤关键字段：

tail -f ~/.claude-code-router/logs/ccr-*.log | jq 'select(.status != 200)'

输出示例：

{
  "level": 40,
  "time": 1735736500000,
  "msg": "API call failed",
  "provider": "gpt-4",
  "model": "gpt-4-turbo",
  "status": 504,
  "duration": 30000
}

此命令可快速定位超时（504）或拒绝访问（403）等错误。

模型路由异常排查

若发现路由决策不符合预期（如未优先选择本地模型），可通过以下命令分析路由日志：

grep "Router selected model" ~/.claude-code-router/claude-code-router.log | tail -20

输出示例：

[2025-09-01T15:35:00.000Z] Router selected model: llama3-70b due to cost optimization
[2025-09-01T15:36:00.000Z] Router selected model: claude-3-sonnet due to latency < 200ms

结合config.json中的路由策略（如cost_threshold、latency_limit），可判断是否因配置错误导致路由异常。

性能瓶颈定位

分析日志中的duration字段，统计API调用耗时分布：

tail -n 1000 ~/.claude-code-router/logs/ccr-*.log | \
  jq -r '.duration' | \
  awk '{sum+=$1; count++} END {print "Avg duration:", sum/count, "ms"}'

若平均耗时超过阈值（如5000ms），需检查网络延迟或模型加载时间。

日志轮转与清理策略

为避免日志文件占用过多磁盘空间,Claude Code Router支持自动轮转与清理：

基于时间的轮转：
每日凌晨3点生成新日志文件，旧文件重命名为ccr-YYYY-MM-DD.log.gz。
基于大小的轮转：
当文件超过100MB时，自动压缩并分割。

手动清理命令：

# 保留最近7天的日志
find ~/.claude-code-router/logs/ -name "ccr-*.log*" -mtime +7 -delete

企业级部署的日志集中管理

在生产环境中,建议将日志推送至ELK（Elasticsearch+Logstash+Kibana）或Splunk等集中式日志系统：

Filebeat配置示例：

filebeat.inputs:
- type: log
  paths: ["~/.claude-code-router/logs/ccr-*.log"]
output.elasticsearch:
  hosts: ["http://elk-server:9200"]

Kibana仪表盘：
创建可视化看板，实时监控API成功率、错误类型分布及模型使用频率。

常见问题解决方案

问题现象	日志分析步骤
API调用频繁返回503错误	检查`ccr-*.log`中`status: 503`的记录，确认是否因模型提供商限流或配额不足。
路由决策未遵循优先级规则	搜索`claude-code-router.log`中`Router selected model`，对比配置文件中的路由策略。
日志文件未生成	检查`config.json`中`LOG`是否为`true`，并确认用户对`~/.claude-code-router/`有写入权限。

通过系统化定位日志文件、结合权限控制与实战分析方法，开发者可高效解决Claude Code Router的运维问题，建议将日志监控纳入CI/CD流程，例如在部署后自动运行健康检查脚本：

#!/bin/bash
ERROR_COUNT=$(grep -c "level\": 40" ~/.claude-code-router/logs/ccr-*.log)
if [ $ERROR_COUNT -gt 0 ]; then
  echo "❌ 检测到$ERROR_COUNT个错误，请检查日志！" | mail -s "Claude Code Router异常" admin@example.com
fi

分享到：