Claudeコード設定ファイル([~/.claude.json])を管理するためのモダンなターミナルユーザーインターフェイス(TUI)アプリケーション。 直感的な階層インターフェイスでMCPサーバー、プロジェクト、会話の管理を簡素化します。

##特徴

MCP サーバー管理

• 階層表示: ツリー構造のグローバルおよびプロジェクトレベルのMCPサーバーをブラウズ
• 追加、編集、削除:MCPサーバー構成のフルCRUD操作
• コピーサーバー: 視覚クリップボードの追跡とサーバー構成をすばやく複製
• サーバーを移動: グローバルスコープとプロジェクト間でサーバーの移動 -マルチスコープサポート:グローバルサーバーとプロジェクト固有のサーバーの両方の管理 -敏感な値のマスキング:デフォルトでマスクされたAPIキーとシークレット([Vを押します)

##プロジェクトと会話管理

• プロジェクトブラウザ:サーバー、会話、履歴カウントですべてのClaudeコードプロジェクトを表示
• 実質の会話管理: 実際の [.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