CooperJiang/coding-tool

기능	설명
지능형 세션 관리	Claude/Codex/Gemini의 과거 세션을 자동으로 식별하며, 이름 지정, 검색, Fork 분기(Branch)를 지원합니다.
다중 채널 부하 분산 (Load Balancing)	여러 채널을 동시에 활성화하고 가중치에 따라 요청을 자동으로 할당하며, 동시성 제어(Concurrency Control) 및 상태 확인(Health Check)을 지원합니다.
동적 채널 전환	여러 API 채널을 관리하며, 재시작 없이 원클릭으로 전환할 수 있어 비용 최적화와 안정성을 동시에 확보합니다.
실시간 Token 모니터링	각 요청의 Token 소모량(입력/출력/캐시 히트)을 시각적으로 보여줍니다.
전체 검색	`⌘/Ctrl + K`를 사용하여 프로젝트 전반에서 세션 내용을 검색하고 과거 대화를 빠르게 찾을 수 있습니다.
현대적인 Web UI	반응형 디자인을 지원하며, 라이트/다크 테마 및 3열 드래그 앤 드롭 정렬을 지원합니다.

npm install -g coding-tool

git clone https://github.com/CooperJiang/cc-tool.git
cd cc-tool
npm install && npm link

ct --version

ct ui

브라우저에서 http://localhost:9999가 자동으로 열리며, 세션과 채널 관리를 시작할 수 있습니다.

ct

대화형 메뉴를 실행하여 키보드로 세션 관리 및 채널 전환을 수행합니다.

명령	설명
`ct`	대화형 명령줄 인터페이스(CLI) 실행
`ct ui`	Web UI 관리 인터페이스 실행
`ct update`	최신 버전 확인 및 업데이트
`ct --version`	버전 번호 표시
`ct --help`	도움말 정보 표시

명령	설명
`ct proxy start`	프록시 서비스 시작 (동적 채널 전환)
`ct proxy stop`	프록시 서비스 중지
`ct proxy status`	프록시 실행 상태 확인

명령	설명
`ct daemon start`	백그라운드에서 서비스 시작 (터미널 종료 가능)
`ct daemon stop`	백그라운드 서비스 중지
`ct daemon restart`	백그라운드 서비스 재시작
`ct daemon status`	백그라운드 서비스 상태 확인
`ct daemon logs`	PM2 실행 로그 확인

명령	설명
`ct logs`	모든 로그 확인
`ct logs ui`	Web UI 로그 확인
`ct logs claude`	Claude 프록시 로그 확인
`ct logs codex`	Codex 프록시 로그 확인
`ct logs gemini`	Gemini 프록시 로그 확인
`ct logs --follow`	로그 출력을 실시간으로 추적
`ct logs --lines 100`	마지막 100줄의 로그 표시
`ct logs --clear`	모든 로그 파일 삭제

명령	설명
`ct doctor`	시스템 진단을 실행하여 설정 및 환경 점검
`ct stats`	사용 통계 확인 (세션 수, Token 등)
`ct reset`	설정 파일 초기화

다중 플랫폼 지원: Claude Code, Codex CLI, Gemini CLI의 세션을 통합 관리합니다. 세션 별칭: 세션에 기억하기 쉬운 이름을 설정하여 식별을 용이하게 합니다. Fork 세션: 기존 대화를 기반으로 분기를 생성하여 다양한 방향을 탐색합니다. 빠른 시작: 터미널에서 과거 세션을 원클릭으로 복구합니다.

다중 채널 부하 분산 (Load Balancing): 여러 채널을 동시에 활성화하고 시스템이 가중치에 따라 요청을 자동으로 할당합니다. 가중치 설정: 각 채널에 가중치(1-100)를 설정하여 높은 가중치의 채널이 더 많은 트래픽을 받도록 합니다. 동시성 제어 (Concurrency Control): 각 채널에 최대 동시 실행 수를 설정하여 부하를 정밀하게 제어합니다. 상태 확인 (Health Check): 채널 상태를 자동으로 감지하며, 문제가 있는 채널은 자동으로 동결 및 복구됩니다. 세션 바인딩: 선택적으로 활성화하여 동일한 세션의 요청이 동일한 채널로 전송되도록 보장합니다. 시각적 설정: 채널을 추가, 편집, 삭제하고 드래그로 우선순위를 조정합니다. 안전한 저장: API Key를 마스킹 처리하여 표시하며, 설정을 로컬에 암호화하여 저장합니다.

PM2 통합: PM2 프로세스 관리를 기반으로 안정적이고 신뢰할 수 있습니다. 지속적 실행: 실행 후 터미널을 종료해도 서비스가 계속 유지됩니다. 부팅 시 자동 실행: 시스템 시작 시 서비스가 자동으로 시작되도록 지원합니다. 로그 관리: 로그를 통합 저장하며 실시간 확인 및 정리를 지원합니다. 상태 모니터링: 백그라운드 서비스의 실행 상태를 언제든 확인할 수 있습니다.

상태 확인 (Health Check): ct doctor

시스템 상태를 원클릭으로 진단합니다.

Node.js 버전 호환성 점검
설정 파일 무결성 검증
포트 점유 상태 감지
디스크 공간 모니터링

로그 관리: ct logs

다양한 로그 확인 및 관리

유형별 필터링 지원 (UI/Claude/Codex/Gemini)
실시간 추적 모드 (--follow)
유연한 행 수 제어

사용 통계: ct stats

상세 통계 정보 확인

세션 수 및 분포
토큰 (Token) 사용 현황
API 호출 통계

WebSocket 푸시: API 요청 상세 정보 실시간 확인
토큰 통계: 입력/출력/캐시 쓰기/캐시 히트 분류 통계
비용 추정: 사용자 정의 가격을 기반으로 API 호출 비용 계산

다중 채널 부하 분산 (Load Balancing) 설정

Web UI의 채널 관리에서 여러 채널을 추가합니다.
채널 카드 위의 「활성화 (Enable)」 버튼을 클릭하여 부하 분산에 참여할 채널을 활성화합니다.
각 채널의 가중치 (Weight) (1-100)를 설정합니다. 가중치가 높을수록 더 많은 요청을 받습니다.
각 채널의 **최대 동시성 (Max Concurrency)**을 설정하여 동시에 처리할 요청 수를 제어합니다.
프록시를 시작하면 시스템이 가중치에 따라 활성화된 각 채널로 요청을 자동으로 할당합니다.

팁: 채널에 문제가 발생하면 자동으로 동결되며, 복구되면 별도의 수동 개입 없이 자동으로 해제됩니다.

백그라운드 실행 서비스

ct daemon start를 사용하여 백그라운드 서비스를 시작합니다.
서비스 시작 후 터미널 창을 안전하게 닫을 수 있습니다.
ct daemon status를 사용하여 언제든지 실행 상태를 확인합니다.
ct daemon logs를 사용하여 실시간 로그를 확인합니다.

장점: 터미널 창을 계속 열어둘 필요 없이 서비스가 지속적으로 실행됩니다.

시스템 진단

문제가 발생하면 먼저 ct doctor를 실행하세요.

종합 진단을 수행합니다:

ct doctor

진단 도구는 다음 항목을 자동으로 점검합니다:

Node.js 버전 호환성
설정 파일 정상 여부
포트 점유 상태
디스크 공간 충분 여부

그리고 그에 따른 맞춤형 수정 제안을 제공합니다.

로그 관리

실시간 로그를 확인하여 문제를 파악하세요:

# 모든 로그 실시간 추적
ct logs --follow
# Claude 프록시 로그의 마지막 100행 확인
...

글로벌 검색

어느 페이지에서든 ⌘/Ctrl + K를 누르세요.
키워드를 입력하여 모든 프로젝트의 세션 내용을 검색합니다.
검색 결과 클릭 시 즉시 대화를 시작할 수 있습니다.

채널 관리

채널 목록에서 「활성화/비활성화 (Enable/Disable)」 버튼을 클릭하여 채널 상태를 전환합니다.
활성화된 채널은 자동으로 부하 분산에 참여합니다.
가중치와 동시성을 언제든지 조정할 수 있으며 즉시 적용됩니다.
채널의 상태가 비정상일 경우 「재설정 (Reset)」을 클릭하여 복구할 수 있습니다.

주의: ct daemon start를 사용하여 백그라운드에서 실행 중일 때, 채널 변경 사항은 실시간으로 적용됩니다.

세션 포크 (Fork Session)

세션 목록에서 Fork 버튼을 클릭합니다.
새 세션은 원본 세션의 모든 히스토리 메시지를 상속받습니다.
동일한 컨텍스트를 기반으로 다양한 방향을 탐색할 수 있습니다.

서비스를 백그라운드에서 실행하려면 어떻게 하나요?

ct daemon start를 사용하여 백그라운드 서비스를 시작하세요. PM2 프로세스 관리를 기반으로 하며, 시작 후 터미널 창을 안전하게 닫을 수 있습니다.

상태 확인: ct daemon status

로그 확인: ct daemon logs

서비스 중지: ct daemon stop

백그라운드 서비스의 자동 실행(Boot)을 설정하려면 어떻게 하나요?

Web UI 설정에서 "부팅 시 자동 실행" 옵션을 켜거나, API를 사용하세요:

ct daemon start
# 그 다음 Web UI 설정에서 자동 실행을 활성화합니다.

실행 로그를 어떻게 확인하나요?

ct logs를 사용하세요.

명령어:

ct logs # 모든 로그 확인
ct logs claude # Claude 프록시 로그 확인
ct logs --follow # 로그 실시간 추적
...

로그 파일은 ~/.claude/logs/ 디렉토리에 저장됩니다.

문제가 발생했을 때 어떻게 진단하나요?

ct doctor를 실행하여 시스템 진단을 수행하세요. 다음 항목을 자동으로 점검합니다:

Node.js 버전
설정 파일
포트 점유
디스크 공간
프로세스 상태

그리고 맞춤형 수정 제안을 제공합니다.

다중 채널 부하 분산을 어떻게 구성하나요?

시스템에 여러 채널을 추가합니다.
부하 분산에 참여할 채널을 활성화합니다.
각 채널에 가중치와 최대 동시성을 설정합니다.
프록시를 시작하면 시스템이 가중치에 따라 요청을 자동으로 할당합니다.

채널에 문제가 발생하면 자동으로 동결되며, 복구되면 자동으로 해제됩니다.

동적 전환이 적용되지 않나요?

1.6.0 버전 이후로는 "기본 채널 (Default Channel)"을 수동으로 전환할 필요가 없습니다. 시스템이 활성화된 모든 채널 간에 자동으로 부하 분산을 수행합니다.

최소 하나 이상의 채널이 활성화 상태인지 확인하세요. 프록시가 시작되면 자동으로 사용됩니다.

실시간 로그가 표시되지 않나요?

실시간 로그를 보려면 먼저 「동적 전환 (Dynamic Switching)」 기능을 켜야 프록시 서비스가 요청을 캡처할 수 있습니다.

ct daemon start를 사용하여 백그라운드에서 실행한 후, ct logs --follow를 통해 실시간 로그를 확인하는 것을 권장합니다.

설정을 어떻게 백업하나요?

다음 디렉토리를 직접 복사하면 모든 설정과 데이터를 백업할 수 있습니다:

설정: ~/.claude/cc-tool/
로그: ~/.claude/logs/

전체 업데이트 로그 확인: CHANGELOG.md

Issue 및 Pull Request 제출을 환영합니다!