一款现代终端用户界面（TUI）应用程序，用于管理 Claude Code 配置文件（~/.claude.json。通过直观的层级界面简化 MCP 服务器、项目和会话的管理。

特色

MCP 服务器管理

• 层级视图：以树状结构浏览全局和项目级MCP服务器
• 添加、编辑、删除：MCP服务器配置的完整CRUD操作
• 复制服务器：快速复制服务器配置，通过可视化剪贴板跟踪
• 移动服务器：在全球范围和项目之间移动服务器
• 多范围支持：管理全球和项目专用服务器
• 敏感值掩蔽：API密钥和密钥默认被掩蔽（按V切换）

项目与对话管理

• 项目浏览器：查看所有Claude Code项目，包含服务器、会话和历史记录
• 真实对话管理：浏览、查看详情，并从文件系统中删除实际的.jsonl对话文件
• 对话统计：查看每段对话的消息数量、文件大小和年龄
• 对话清理：删除带有完整元数据可见性的旧对话

Claude Code Config

A modern Terminal User Interface (TUI) application for managing Claude Code configuration files (~/.claude.json). Simplify the management of MCP servers, projects, and conversations with an intuitive hierarchical interface.

Features

MCP Server Management

• Hierarchical View: Browse global and project-level MCP servers in a tree structure
• Add, Edit, Delete: Full CRUD operations for MCP server configurations
• Copy Servers: Quickly duplicate server configurations with visual clipboard tracking
• Move Servers: Move servers between global scope and projects
• Multi-Scope Support: Manage both global and project-specific servers
• Sensitive Value Masking: API keys and secrets masked by default (press V to toggle)

Project & Conversation Management

• Project Browser: View all your Claude Code projects with server, conversation, and history counts
• Real Conversation Management: Browse, view details, and delete actual .jsonl conversation files from filesystem
• Conversation Statistics: See message count, file size, and age for each conversation
• Conversation Cleanup: Delete old conversations with full metadata visibility
• History Management: View, delete, and move history items between projects
• Project Organization: See which MCP servers are configured for each project

Safety & Reliability

• Automatic Backups: Creates timestamped backups before every save
• Undo/Redo System: Full undo/redo support with Ctrl+Z/Ctrl+Y (up to 50 actions)
• JSON Validation: Ensures your configuration remains valid
• Rollback Support: Easily restore from backups if needed
• Non-destructive Operations: Confirm before deleting
• Error Logging: Persistent error log with export capability (press l to view)

Advanced Features

• Environment Variable Support: Handle ${VAR} syntax in server configs
• HTTP/SSE Servers: Support for stdio, HTTP, and SSE server types with headers support
• Large File Handling: Efficiently manages large config files (handles multi-MB files)
• Visual Navigation: Intuitive tree-based navigation with focus management
• Visual Change Indicators: See unsaved changes with * in title bar and orange save button
• Enhanced Clipboard: Copy/paste servers and history with visual status tracking

Installation

From PyPI

pip install claude-code-config

From Source

git clone https://github.com/joeyism/claude-code-config.git
cd claude-code-config
pip install -e .

Usage

Launch the TUI application:

claude-config
# or use the short alias
ccm

Keyboard Shortcuts

Navigation

• ↑/↓ or j/k: Navigate tree
• Enter or Space: Expand/collapse tree nodes
• Right/Left: Expand/collapse nodes

Actions

• a: Add new MCP server or history item