Claude Code : Serena Plug-In

⏺ Serena란?
   Serena는 오픈소스 AI 코딩 에이전트 툴킷으로,
   Claude Code에 시맨틱 코드 분석 기능을 추가하는 MCP 서버입니다.

⏺ 핵심 기능
- 코드베이스 인덱싱: 프로젝트를 분석해서 .serena/memories/에 마크다운으로 구조를 저장
- 심볼 단위 코드 이해: LSP(Language Server Protocol)를 활용해 함수, 클래스, 변수 수준으로 코드를 파악
- 토큰 절약: 전체 파일을 읽지 않고 필요한 코드만 읽어서 토큰 약 70% 절약 효과
- 다국어 지원: Python, JavaScript, TypeScript, Java, Kotlin 등

⏺ 왜 쓰는가?
Claude Code는 자체 인덱싱이 없어서 매번 파일을 읽어야 합니다.
Serena를 붙이면 코드베이스를 미리 분석해두고 필요한 부분만 빠르게 접근할 수 있어서
대규모 프로젝트에서 효율이 크게 올라갑니다.

⏺ 언제 효과적인가?
    파일이 많고 복잡한 기존 프로젝트 분석/수정 시 효과 큼
    처음부터 새로 코드를 작성하는 경우에는 큰 효과 없음

⏺ 비용
   - 완전 무료, 오픈소스.
   - 로컬에서 실행되어 코드가 외부 서버로 나가지 않음

인텔리J에서는 플러그인 찾아서 셋팅!

터미널에서는 아래와 같이 셋팅!

# uv 먼저 설치
brew install uv

# Claude Code에 Serena MCP 등록
claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context claude-code
```

**프로젝트마다 활성화**
```
# Claude Code 실행 후 채팅에서
"Activate the current dir as project using serena"