# 啟動 Claude Code 并進(jìn)入交互模式
claude
# 使用 --debug 參數(shù)獲取詳細(xì)調(diào)試信息
claude --debug
# 指定工作目錄
claude --working-dir /path/to/project
# 查看當(dāng)前會話狀態(tài)
/status
# 查看模型配置
/model

# 第一步：確認(rèn)環(huán)境
pwd
ls -la

# 第二步：檢查配置文件
cat .claude/config.json
cat CLAUDE.md

# 第三步：驗(yàn)證權(quán)限
ls -la .claude/

# 第四步：測試基本功能
claude --version

# Python 示例：使用斷點(diǎn)
def process_data(data):
    print(f"[DEBUG] 輸入數(shù)據(jù): {data}")  # 調(diào)試輸出
    result = transform(data)
    print(f"[DEBUG] 處理結(jié)果: {result}")  # 調(diào)試輸出
    return result
# 使用 assert 進(jìn)行條件檢查
def validate_input(value):
    assert value is not None, "輸入值不能為 None"
    assert isinstance(value, str), f"期望字符串類型，實(shí)際為 {type(value)}"
    return value.strip()

// JavaScript 示例：控制臺調(diào)試
function analyzeRequest(req) {
  console.log('=== 調(diào)試開始 ===');
  console.log('請求對象:', JSON.stringify(req, null, 2));
  const result = processRequest(req);
  console.log('處理結(jié)果:', result);
  console.log('=== 調(diào)試結(jié)束 ===');
  return result;
}
// 使用 debugger 關(guān)鍵字
function complexCalculation(input) {
  debugger; // 瀏覽器會在此處暫停
  return input * 2;
}

# 啟用詳細(xì)日志
export CLAUDE_DEBUG=true
claude

# 查看環(huán)境變量
env | grep CLAUDE

# 臨時設(shè)置調(diào)試模式
CLAUDE_DEBUG=true claude

# 查看配置路徑
echo $CLAUDE_CONFIG_PATH

# 交互式調(diào)試 - 逐步執(zhí)行
claude --interactive

# 非交互模式 - 批量處理
claude --no-interactive "分析當(dāng)前項(xiàng)目結(jié)構(gòu)"

# 詳細(xì)輸出模式
claude --verbose "幫我調(diào)試這個函數(shù)"

# 錯誤示例
Error: Configuration file not found at ~/.claude/config.json

# 解決方案
mkdir -p ~/.claude
claude config init

# 錯誤示例
Error: Permission denied: /path/to/file

# 解決方案
ls -la /path/to/file  # 檢查權(quán)限
chmod 644 /path/to/file  # 修復(fù)權(quán)限
# 或使用 sudo（謹(jǐn)慎）
sudo chown $USER:$USER /path/to/file

# 錯誤示例
Error: Network request failed: ECONNREFUSED
Error: API rate limit exceeded

# 解決方案
# 檢查網(wǎng)絡(luò)連接
ping api.anthropic.com

# 檢查代理設(shè)置
echo $HTTP_PROXY
echo $HTTPS_PROXY

# 重試機(jī)制
claude --retry-count 3 --retry-delay 5

# 錯誤示例
Error: Model not available: claude-3-opus-20240229
Error: Context length exceeded

# 解決方案
# 切換模型
/model claude-3-sonnet

# 清理上下文
/clear
# 或重啟會話

# 示例錯誤輸出分析
Error: ENOENT: no such file or directory, open '/project/.claude/settings.json'
    at Object.openSync (node:fs:585:3)
    at Object.readFileSync (node:fs:453:35)
    at loadConfig (/usr/local/lib/node_modules/claude-code/dist/config.js:45:12)

# 分析：
# ENOENT - 文件不存在錯誤
# 路徑: /project/.claude/settings.json
# 調(diào)用棧: config.js 第45行 loadConfig 函數(shù)

# Python 錯誤處理示例
import logging
from typing import Optional
# 配置日志
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)
def safe_execute(func, *args, **kwargs):
    """安全的執(zhí)行函數(shù)，帶有完善的錯誤處理"""
    try:
        result = func(*args, **kwargs)
        logger.info(f"執(zhí)行成功: {func.__name__}")
        return result
    except FileNotFoundError as e:
        logger.error(f"文件未找到: {e.filename}")
        return None
    except PermissionError as e:
        logger.error(f"權(quán)限不足: {e}")
        return None
    except Exception as e:
        logger.exception(f"未預(yù)期的錯誤: {e}")
        return None

// JavaScript 錯誤處理示例
class ClaudeErrorHandler {
  constructor() {
    this.retryCount = 3;
    this.retryDelay = 1000;
  }
  async executeWithRetry(operation, context = {}) {
    for (let i = 0; i < this.retryCount; i++) {
      try {
        const result = await operation();
        console.log(`[${context.name || 'Operation'}] 成功`);
        return result;
      } catch (error) {
        console.error(`[${context.name || 'Operation'}] 嘗試 ${i + 1} 失敗:`, error.message);
        if (i === this.retryCount - 1) {
          throw new Error(`操作失敗，已重試 ${this.retryCount} 次: ${error.message}`);
        }
        await new Promise(resolve => setTimeout(resolve, this.retryDelay * (i + 1)));
      }
    }
  }
}
// 使用示例
const handler = new ClaudeErrorHandler();
await handler.executeWithRetry(
  () => claude.analyze(file),
  { name: 'FileAnalysis' }
);

# Claude Code 日志位置
~/.claude/logs/           # 主日志目錄
~/.claude/logs/main.log    # 主日志文件
~/.claude/logs/debug.log   # 調(diào)試日志
~/.claude/logs/error.log   # 錯誤日志

# 項(xiàng)目級日志
./.claude/logs/           # 項(xiàng)目日志目錄

# 查看最近的日志
tail -100 ~/.claude/logs/main.log

# 實(shí)時監(jiān)控日志
tail -f ~/.claude/logs/debug.log

# 搜索特定錯誤
grep -i "error" ~/.claude/logs/*.log

# 按時間過濾日志
grep "2024-01-15" ~/.claude/logs/main.log

# 統(tǒng)計(jì)錯誤類型
grep -oP '(?<=ERROR\s)[\w_]+' ~/.claude/logs/main.log | sort | uniq -c | sort -rn

# 查看調(diào)用棧
grep -A 10 "Error:" ~/.claude/logs/error.log

// 日志格式示例
{
  "timestamp": "2024-01-15T10:30:45.123Z",
  "level": "ERROR",
  "logger": "ClaudeCode.API",
  "message": "API request failed",
  "context": {
    "requestId": "req_abc123",
    "endpoint": "/v1/messages",
    "statusCode": 429,
    "retryAfter": 60
  },
  "stack": "Error: Rate limit exceeded\n    at APIClient.request..."
}

#!/usr/bin/env python3
"""
Claude Code 日志分析工具
"""
import json
import re
from datetime import datetime
from collections import Counter, defaultdict
from pathlib import Path
class LogAnalyzer:
    def __init__(self, log_path: str):
        self.log_path = Path(log_path)
        self.entries = []
    def parse_logs(self):
        """解析日志文件"""
        with open(self.log_path, 'r', encoding='utf-8') as f:
            for line in f:
                entry = self._parse_line(line.strip())
                if entry:
                    self.entries.append(entry)
    def _parse_line(self, line: str) -> dict:
        """解析單行日志"""
        # 嘗試 JSON 格式
        if line.startswith('{'):
            try:
                return json.loads(line)
            except json.JSONDecodeError:
                pass
        # 嘗試文本格式
        pattern = r'\[(\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}[.\d]*Z?)\]\s+\[(\w+)\]\s+(.+)'
        match = re.match(pattern, line)
        if match:
            return {
                'timestamp': match.group(1),
                'level': match.group(2),
                'message': match.group(3)
            }
        return {'message': line, 'level': 'UNKNOWN'}
    def analyze_errors(self) -> dict:
        """分析錯誤統(tǒng)計(jì)"""
        error_counts = Counter()
        error_contexts = defaultdict(list)
        for entry in self.entries:
            if entry.get('level') == 'ERROR':
                message = entry.get('message', '')
                error_type = message.split(':')[0] if ':' in message else message
                error_counts[error_type] += 1
                error_contexts[error_type].append(entry)
        return {
            'total_errors': sum(error_counts.values()),
            'error_types': dict(error_counts.most_common(10)),
            'contexts': dict(error_contexts)
        }
    def time_series_analysis(self) -> dict:
        """時間序列分析"""
        hourly_counts = defaultdict(lambda: defaultdict(int))
        for entry in self.entries:
            ts = entry.get('timestamp', '')
            level = entry.get('level', 'UNKNOWN')
            # 提取小時
            try:
                dt = datetime.fromisoformat(ts.replace('Z', '+00:00'))
                hour_key = dt.strftime('%Y-%m-%d %H:00')
                hourly_counts[hour_key][level] += 1
            except:
                pass
        return dict(hourly_counts)
    def generate_report(self) -> str:
        """生成分析報告"""
        error_analysis = self.analyze_errors()
        time_analysis = self.time_series_analysis()
        report = []
        report.append("=" * 50)
        report.append("Claude Code 日志分析報告")
        report.append("=" * 50)
        report.append(f"\n總?cè)罩緱l目: {len(self.entries)}")
        report.append(f"總錯誤數(shù): {error_analysis['total_errors']}")
        report.append("\n錯誤類型 TOP 10:")
        for error_type, count in error_analysis['error_types'].items():
            report.append(f"  {error_type}: {count} 次")
        return "\n".join(report)
# 使用示例
if __name__ == "__main__":
    analyzer = LogAnalyzer("~/.claude/logs/main.log")
    analyzer.parse_logs()
    print(analyzer.generate_report())

# 方法 1：使用快速啟動模式
claude --quick-start

# 方法 2：預(yù)加載常用配置
claude --preload-config

# 方法 3：減少啟動檢查
claude --skip-checks

# 方法 4：使用配置緩存
# 在 .claude/settings.json 中設(shè)置
{
  "performance": {
    "cacheEnabled": true,
    "preloadContext": true,
    "lazyLoadPlugins": true
  }
}

# CLAUDE.md 優(yōu)化建議
## 不推薦 - 過大的上下文
- 包含整個項(xiàng)目的所有文件
- 嵌入大量文檔內(nèi)容
- 未壓縮的歷史記錄
## 推薦 - 精簡的上下文
- 只包含必要的項(xiàng)目信息
- 使用摘要代替完整內(nèi)容
- 定期清理過時信息

# 清理上下文
/clear          # 清除當(dāng)前會話
/prune          # 修剪舊對話
/compact        # 壓縮上下文

// 網(wǎng)絡(luò)請求優(yōu)化配置
const networkConfig = {
  // 連接池配置
  connectionPool: {
    maxConnections: 10,
    keepAlive: true,
    timeout: 30000
  },
  // 請求重試策略
  retry: {
    maxRetries: 3,
    initialDelay: 1000,
    maxDelay: 10000,
    multiplier: 2
  },
  // 緩存策略
  cache: {
    enabled: true,
    ttl: 300000, // 5分鐘
    maxSize: 100 * 1024 * 1024 // 100MB
  },
  // 請求批處理
  batch: {
    enabled: true,
    maxBatchSize: 10,
    maxWaitTime: 100 // ms
  }
};

# 監(jiān)控內(nèi)存使用
claude --inspect-memory

# 設(shè)置內(nèi)存限制
claude --max-memory 2048  # 2GB

# 定期垃圾回收
claude --gc-interval 300  # 每5分鐘

// Node.js 內(nèi)存優(yōu)化示例
const v8 = require('v8');
// 獲取堆統(tǒng)計(jì)
function getHeapStats() {
  const stats = v8.getHeapStatistics();
  return {
    totalHeapSize: Math.round(stats.total_heap_size / 1024 / 1024) + 'MB',
    usedHeapSize: Math.round(stats.used_heap_size / 1024 / 1024) + 'MB',
    heapSizeLimit: Math.round(stats.heap_size_limit / 1024 / 1024) + 'MB'
  };
}
// 強(qiáng)制垃圾回收（需要 --expose-gc 標(biāo)志）
function forceGC() {
  if (global.gc) {
    global.gc();
    console.log('垃圾回收完成');
  }
}
// 內(nèi)存使用監(jiān)控
setInterval(() => {
  const used = process.memoryUsage();
  console.log({
    rss: Math.round(used.rss / 1024 / 1024) + 'MB',
    heapTotal: Math.round(used.heapTotal / 1024 / 1024) + 'MB',
    heapUsed: Math.round(used.heapUsed / 1024 / 1024) + 'MB',
    external: Math.round(used.external / 1024 / 1024) + 'MB'
  });
}, 60000); // 每分鐘輸出一次

# Python 響應(yīng)處理優(yōu)化
import asyncio
from typing import AsyncGenerator
async def stream_response(generator: AsyncGenerator):
    """流式響應(yīng)處理，減少首字節(jié)時間"""
    buffer = []
    buffer_size = 0
    max_buffer = 1024  # 1KB 緩沖
    async for chunk in generator:
        buffer.append(chunk)
        buffer_size += len(chunk)
        # 緩沖區(qū)滿時輸出
        if buffer_size >= max_buffer:
            yield ''.join(buffer)
            buffer = []
            buffer_size = 0
    # 輸出剩余內(nèi)容
    if buffer:
        yield ''.join(buffer)
# 并行處理優(yōu)化
async def parallel_analysis(files: list[str]):
    """并行分析多個文件"""
    tasks = [analyze_file(f) for f in files]
    results = await asyncio.gather(*tasks, return_exceptions=True)
    success = []
    errors = []
    for file, result in zip(files, results):
        if isinstance(result, Exception):
            errors.append((file, str(result)))
        else:
            success.append((file, result))
    return {'success': success, 'errors': errors}

#!/bin/bash
# Claude Code 性能監(jiān)控腳本
echo "=== Claude Code 性能監(jiān)控 ==="
echo ""
# 1. 進(jìn)程狀態(tài)
echo ">>> 進(jìn)程狀態(tài)"
ps aux | grep claude | grep -v grep
# 2. 內(nèi)存使用
echo ""
echo ">>> 內(nèi)存使用"
ps -o pid,rss,vsz,pmem,comm -p $(pgrep -f "claude") 2>/dev/null || echo "未找到運(yùn)行中的 Claude 進(jìn)程"
# 3. CPU 使用
echo ""
echo ">>> CPU 使用率"
top -l 1 -pid $(pgrep -f "claude") 2>/dev/null | grep -A 5 "PID" || echo "無法獲取 CPU 信息"
# 4. 網(wǎng)絡(luò)連接
echo ""
echo ">>> 網(wǎng)絡(luò)連接"
lsof -i -P | grep claude 2>/dev/null | head -10
# 5. 日志文件大小
echo ""
echo ">>> 日志文件大小"
du -sh ~/.claude/logs/ 2>/dev/null || echo "日志目錄不存在"
# 6. 配置緩存
echo ""
echo ">>> 緩存狀態(tài)"
ls -lh ~/.claude/cache/ 2>/dev/null || echo "無緩存目錄"
echo ""
echo "=== 監(jiān)控完成 ==="

# 問題
npm install -g @anthropic-ai/claude-code
# Error: EACCES permission denied

# 解決方案 1：使用 nvm 管理 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install node
nvm use node
npm install -g @anthropic-ai/claude-code

# 解決方案 2：修復(fù) npm 權(quán)限
sudo chown -R $(whoami) ~/.npm
npm install -g @anthropic-ai/claude-code

# 解決方案 3：使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 問題
# Error: peer dep missing: some-package@^x.x.x

# 解決方案
# 清理并重新安裝
rm -rf node_modules package-lock.json
npm install

# 或使用 --legacy-peer-deps
npm install --legacy-peer-deps

# 問題
# Error: Invalid API key

# 解決方案
# 1. 檢查 API Key 格式
echo $ANTHROPIC_API_KEY

# 2. 重新設(shè)置 API Key
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# 3. 永久保存
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc

# 4. 驗(yàn)證 API Key
claude auth test

# 問題
# Error: Authentication expired

# 解決方案
# 重新認(rèn)證
claude auth login

# 或使用 API Key 認(rèn)證
claude auth login --api-key

# 問題
# Error: ETIMEDOUT

# 解決方案 1：檢查網(wǎng)絡(luò)
ping api.anthropic.com

# 解決方案 2：設(shè)置代理
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

# 解決方案 3：增加超時時間
claude --timeout 60000  # 60秒

# 解決方案 4：使用國內(nèi)鏡像（如果適用）
claude --api-endpoint "https://custom-endpoint.com"

# 問題
# Error: UNABLE_TO_VERIFY_LEAF_SIGNATURE

# 解決方案 1：更新 CA 證書
# macOS
brew install ca-certificates

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install ca-certificates

# 解決方案 2：臨時禁用 SSL 驗(yàn)證（不推薦）
NODE_TLS_REJECT_UNAUTHORIZED=0 claude

# 問題
# Error: context_length_exceeded

# 解決方案 1：清理上下文
/clear

# 解決方案 2：壓縮對話
/compact

# 解決方案 3：減少文件引用
# 精簡 CLAUDE.md，移除不必要內(nèi)容

# 解決方案 4：切換大上下文模型
/model claude-3-opus-20240229

# 問題
# Error: Command execution failed

# 解決方案 1：檢查命令權(quán)限
ls -la $(which claude)

# 解決方案 2：檢查 shell 配置
echo $SHELL
cat ~/.zshrc | grep claude

# 解決方案 3：檢查工作目錄
pwd
ls -la

# 解決方案 4：查看詳細(xì)錯誤
claude --debug "執(zhí)行命令"

# 問題
# Error: Invalid JSON in config file

# 解決方案 1：驗(yàn)證 JSON 格式
cat ~/.claude/config.json | python3 -m json.tool

# 解決方案 2：重置配置
rm ~/.claude/config.json
claude config init

# 解決方案 3：使用備份
cp ~/.claude/config.json.backup ~/.claude/config.json

# 問題
# Error: Plugin initialization failed

# 解決方案 1：檢查插件目錄
ls -la ~/.claude/plugins/

# 解決方案 2：禁用問題插件
claude plugin disable problematic-plugin

# 解決方案 3：清理插件緩存
rm -rf ~/.claude/plugins/.cache
claude plugin reload

# 問題
# 響應(yīng)時間過長

# 診斷步驟
# 1. 檢查網(wǎng)絡(luò)延遲
ping -c 5 api.anthropic.com

# 2. 檢查系統(tǒng)資源
top -l 1 | head -10

# 3. 檢查日志
tail -50 ~/.claude/logs/debug.log

# 解決方案 1：優(yōu)化上下文
# 減少不必要的文件引用

# 解決方案 2：使用更快的模型
/model claude-3-haiku

# 解決方案 3：啟用緩存
claude --cache

# 解決方案 4：清理歷史
/prune --days 7

# 問題
# Claude Code 內(nèi)存使用超過預(yù)期

# 解決方案 1：限制內(nèi)存
claude --max-memory 1024

# 解決方案 2：定期重啟
# 設(shè)置定時任務(wù)重啟服務(wù)

# 解決方案 3：清理緩存
rm -rf ~/.claude/cache/*

# 解決方案 4：監(jiān)控內(nèi)存泄漏
claude --inspect-memory --interval 60