Claude Code 세션 시각화 및 규칙 관리를 위한 VS Code 확장 프로그램 'Akashi'

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code로 개발된 Akashi는 AI 에이전트의 규칙 구조와 세션 실행 데이터(Gantt 차트, 토큰 등)를 시각화하는 VS Code 확장 프로그램이다.

배경

Claude Code의 복잡한 규칙 설정과 세션 복기의 어려움을 해결하기 위해 작성자가 직접 개발한 시각화 도구 Akashi를 소개하고 오픈소스로 공개했다.

의미 / 영향

AI 에이전트의 내부 작동 과정을 시각화함으로써 개발자는 에이전트의 병렬 처리 능력과 도구 사용 패턴을 더 깊이 이해할 수 있다. 복잡한 규칙 시스템을 그래프로 관리하는 방식은 대규모 AI 프로젝트의 가이드라인 충돌 문제를 해결하는 실무적 대안이 된다.

커뮤니티 반응

작성자가 도구를 공유하며 피드백을 요청했으며, AI 에이전트 사용 경험을 개선하려는 시도에 대해 긍정적인 반응이 나타났다.

주요 논점

01찬성다수

AI 에이전트의 복잡한 세션과 규칙을 시각화하는 도구가 개발 생산성 향상에 필수적이다.

합의점 vs 논쟁점

합의점

Claude Code의 병렬 실행 과정을 시각적으로 확인하는 것이 성능 분석에 유용하다.

실용적 조언

Akashi의 Gantt 뷰를 사용하여 Claude Code가 어떤 도구에서 시간을 많이 소요하는지 확인한다.
D3 그래프 뷰를 통해 CLAUDE.md와 .claude/rules/ 간의 참조 관계를 점검하여 규칙 충돌을 방지한다.

섹션별 상세

규칙 관리의 복잡성 해결을 위해 CLAUDE.md, .claude/rules/, .mcp.json 등 산재한 규칙 파일 간의 관계를 파악하는 통합 트리 뷰를 도입했다. D3 force-directed graph를 사용하여 파일 간의 포함 및 참조 관계를 시각적으로 연결하여 보여준다. 이를 통해 사용자는 규칙 간의 충돌을 방지하고 전체적인 가이드라인 구조를 명확히 이해할 수 있다.

Pulse 분석 대시보드는 ~/.claude/projects/ 경로의 JSONL 세션 데이터를 파싱하여 에이전트의 활동을 시각화한다. Gantt 차트를 통해 Read, Write, Bash 등 각 도구가 실행된 시점과 병렬 처리 과정을 상세히 추적할 수 있도록 설계했다. 사용자는 이를 통해 Claude Code의 병렬 처리 성능을 확인하고 세션이 지연되는 병목 지점을 수치로 파악한다.

AI 에이전트를 활용한 도구 개발 경험 측면에서 Akashi의 전체 코드베이스는 Claude Code를 주요 코딩 파트너로 삼아 구축되었다. 도메인 주도 설계(DDD) 아키텍처 수립부터 React 웹뷰 구현, JSONL 파서 작성, VS Code API 통합에 이르기까지 전 과정에 AI 에이전트가 참여했다. 약 160개의 커밋을 통해 AI와 협업하여 복잡한 시각화 도구를 완성할 수 있음을 실증했다.

실무 Takeaway

Akashi는 Claude Code의 규칙 파일을 통합 시각화하여 관리 편의성을 높인다.
Gantt 차트를 통해 AI 에이전트의 도구 호출 시점과 병렬 처리 효율을 분석할 수 있다.
세션별 토큰 사용량과 하위 에이전트 구조를 파악하여 비용 및 성능 최적화 근거를 확보한다.
이 도구 자체를 Claude Code와 협업하여 개발함으로써 AI 에이전트의 실무 활용 가능성을 입증했다.

언급된 도구

Akashi추천링크

Claude Code 세션 및 규칙 시각화 VS Code 확장 프로그램

Claude Code추천

Anthropic의 CLI 기반 코딩 에이전트

Cursor중립

AI 기반 코드 에디터 (Akashi 지원 대상)

Gemini중립

Google의 LLM (Akashi 규칙 지원 대상)

언급된 리소스

GitHubAkashi GitHub Repository

API DocsVS Code Marketplace: Akashi

API DocsOpen VSX: Akashi