Serena의 개요
Oraios AI가 만든 Serena는 코딩 에이전트에게 IDE가 가진 코드 탐색과 편집 도구를 주는 MCP 서버입니다. 에이전트는 파일 전체를 읽고 줄 번호로 수정하는 대신 심볼을 찾고, 그 심볼을 참조하는 곳을 나열하고, 함수 본문을 바꾸거나 프로젝트 전체에서 심볼 이름을 바꿀 수 있습니다. 버전 2.0.0(2026년 10월 13일)은 에이전트가 도구 호출을 하나씩 하는 대신 코드를 제출하는 REPL 기반 인터페이스를 추가했고, 10월 19일에 2.1.0이 뒤따랐습니다. 저장소의 GitHub 스타는 약 30,600개입니다.
기본적으로는 언어 서버(편집기가 정의로 이동 기능에 쓰는 엔진)로 작동하며, README에 따르면 40개가 넘는 언어를 다룹니다. 두 번째 백엔드는 JetBrains IDE용 유료 Serena 플러그인으로, 이동, 인라인, 타입 계층, 대화형 디버거를 추가합니다. 간단한 메모리 시스템과 선택적인 파일, 검색, 셸 도구도 있으며, 이 도구들은 Claude Code처럼 이미 같은 도구를 갖춘 환경에서는 기본적으로 꺼집니다.
uv로 설치하고(uv tool install -p 3.13 serena-agent) serena init을 실행한 뒤, 클라이언트가 stdio나 HTTP로 연결하게 합니다. 세션마다 localhost:24282에서 웹 대시보드가 시작됩니다.
Serena 설치 방법
uv tool install -p 3.13 serena-agentSerena, 쓸 만한 가치가 있습니까?
대부분 의 코딩 에이전트는 아직도 grep과 파일 전체 읽기로 프로젝트를 탐색하고, 텍스트 일치로 수정합니다. Serena는 이를 심볼을 이해하는 작업으로 바꿉니다. 함수를 찾고, 모든 호출자를 보고, 본문을 바꾸고, 모든 곳에서 이름을 바꿉니다. 큰 코드베이스에서는 읽는 데 쓰는 토큰이 줄고 깨지는 수정도 줄어듭니다. 이것이 핵심 주장이지만, 절감 효과는 독립적으로 측정된 것이 아니라 유지 관리자가 주장하는 것입니다.
무료 언어 서버 백엔드가 핵심 기능을 다룹니다. 심볼 찾기, 참조, 파일 개요, 진단, 심볼 이름 바꾸기, 심볼 단위 편집입니다. 더 큰 리팩터링(이동, 인라인, 쓰지 않는 코드 제거)과 디버깅에는 유료 JetBrains 플러그인이 필요합니다. 그래서 무료 요금제는 기능표가 처음 주는 인상보다 좁고, 일부 언어는 언어 서버를 따로 설치해야 합니다.
점수가 낮은 이유는 보안입니다. Serena의 보안 페이지는 작업 대상 저장소를 신뢰한다고 가정한다고 밝히며, 2026년은 그것이 무엇을 뜻하는지 보여 주었습니다. 공개된 보안 권고가 세 건이었고, 모두 코드 실행으로 이어졌습니다. 심각한 템플릿 인젝션 결함(1.7.0에서 수정)과 pickle로 직렬화된 심볼 캐시(2.0.0에서 수정)는 악성 저장소가 활성화되기만 해도 코드를 실행할 수 있게 했습니다. 그보다 앞선 버그는 어떤 웹 페이지든 DNS 리바인딩으로 인증 없는 대시보드에 접근할 수 있게 했습니다(1.5.2에서 수정). 모두 패치되었지만, 신뢰할 수 없는 코드에 에이전트를 붙이는 사람은 유지 관리자들 스스로 권하듯 Serena를 컨테이너 안에서 돌려야 합니다.
주목할 기본값이 두 가지 있습니다. 대시보드가 세션마다 시작되고, SERENA_USAGE_REPORTING을 false로 설정하지 않으면 Serena가 시작 할 때 익명 사용 데이터를 보고합니다. README의 "평가"는 AI 에이전트가 도구를 칭찬하는 말을 인용한 것으로, 근거라기보다 마케팅입니다. 또 README는 MCP나 플러그인 마켓플레이스의 명령이 오래되었으므로 그곳에서 설치하지 말라고 경고합니다.
일부 팀에게는 라이선스가 중요합니다. 애플리케이션은 GPL-3.0-or-later이고 기여에는 CLA가 필요합니다. 로컬 도구로 돌리는 것은 괜찮지만 비공개 제품에 넣는 것은 안 됩니다. 작은 스크립트에서는 설정과 추가 도구 설명이 아끼는 것보다 비용이 더 들고, 에이전트에 내장된 grep과 편집으로 충분합니다.
제 역할을 하는 곳
대형 Java 모노레포를 맡은 백엔드 엔지니어
널리 쓰이는 서비스 메서드의 이름을 바꾸고 모든 호출자를 갱신하기
언어 서버 백엔드를 쓰면 에이전트가 수백 개 파일에서 grep으로 찾아 텍스트를 고치는 대신, 호출 한 번으로 참조를 찾고 심볼 이름을 바꿉니다. 무료이며, 작업이 클래스를 패키지 사이로 옮기는 수준으로 커지면 JetBrains 플러그인이 필요해집니다.
개발자 8명에게 Claude Code를 도입하는 Python 팀 리더
에이전트가 파일 전체를 읽는 데 쓰는 토큰 줄이기
파일 개요와 심볼 조회 덕분에 에이전트는 2,000줄짜리 모듈 대신 함수 하나만 읽습니다. Serena는 중복을 피하려고 Claude Code 안에서는 자체 파일 도구와 셸 도구를 끕니다. 비용은 개발자마다 uv로 설치하는 수고와, web_dashboard_open_on_launch를 끄지 않으면 세션마다 뜨는 대시보드 창입니다.
외부 풀 리퀘스트를 에이전트로 검토하는 오픈소스 유지 관리자
작업용 컴퓨터를 노출하지 않고 낯선 기여 코드를 탐색하기
체크아웃만 마운트한 Docker 컨테이너 안에서 Serena 2.0.0 이상을 실행하고, 기여자의 포크는 trusted_project_path_patterns에 넣지 않습니다. 보안 모델이 저장소를 신뢰한다고 가정하며, 2026년의 보안 권고 두 건은 악성 저장소가 활성화 시점에 코드를 실행할 수 있음을 보여 주었습니다.
도입 전 확인할 점
- 설정
- uv를 설치한 뒤 uv tool install -p 3.13 serena-agent와 serena init을 실행합니다. 클라이언트 안내는 Claude Code, Codex, Claude Desktop, MCP를 지원하는 IDE를 다루며 stdio나 HTTP로 연결합니다. 일부 언어 서버는 직접 설치해야 하고, 나머지는 고정된 버전과 SHA256 검증을 거쳐 필요할 때 내려받습니다.
- 연동
- 찾기, 참조, 개요, 선언, 구현, 진단, 이름 바꾸기, 심볼 단위 편집을 위한 심볼 도구와, 메모리, 선택적인 정 규식 검색, 파일 도구, 셸 도구가 있습니다. JetBrains 플러그인은 이동, 인라인, 타입 계층, 의존성 검색, 디버거를 추가합니다. Rider와 CLion은 지원하지 않습니다.
- 데이터와 개인정보
- 사용자 권한으로 로컬에서 실행되며 파일을 수정하고 셸 명령을 실행할 수 있습니다. SERENA_USAGE_REPORTING=false가 아니면 시작할 때 익명 사용 데이터가 Oraios로 전송되고, 대시보드는 localhost:24282에서 설정과 메모리를 수정할 수 있습니다.
- 대규모 사용 시 비용
- 언어 서버 백엔드는 팀 규모와 관계없이 무료입니다. JetBrains 플러그인은 JetBrains Marketplace에서 월 $5 또는 연 $50이며 7일 체험이 있으므로, 개발자 20명 팀은 연간 청구로 1년에 약 $1,000를 냅니다.
- 제한
- 언어 서버의 이름 바꾸기는 심볼만 다루고 파일이나 디렉터리는 다루지 않으며, 외부 의존성에 대해서는 선언 찾기가 대개 실패합니다. REPL 인터페이스에서는 모든 작업이 같은 도구 호출로 나타나므로, 클라이언트 쪽 승인으로는 읽기와 쓰기를 구별할 수 없습니다.
좋은 점
- 텍스트가 아니라 심볼 단위로 찾고, 참조하고, 이름을 바꾸고, 수정합니다
- 무료 언어 서버 백엔드가 40개 이상의 언어를 다룹니다
- Claude Code, Codex, Cursor, JetBrains 어시스턴트 등과 함께 작동합니다
- 활발히 개발 중이며 2026년 10월 19일에 v2.1.0이 나왔습니다
아쉬운 점
- 2026년에 코드 실행 보안 권고가 세 건 있었고, 저장소를 신뢰한다고 가정합니다
- 이동, 인라인, 디버깅에는 유료 JetBrains 플러그인이 필요합니다
- 대시보드와 사용 데이터 보고가 기본으로 켜져 있습니다
- 상용 제품에 넣을 때는 GPL 라이선스와 CLA가 문제가 됩니다
추천 대상
신뢰하는 대규모, 타입이 있는 코드베이스나 여러 언어가 섞인 코드베이스에서 코딩 에이전트를 돌리며, 파일 간 탐색과 이름 바꾸기를 믿고 맡기고 싶은 개발자.
Serena 대안
Serena: 자주 묻는 질문
- Serena, 쓸 만한 가치가 있습니까?
- Serena의 심볼 단위 도구는 큰 코드베이스에서 일하는 에이전트에게 실질적인 개선입니다. 다만 저장소를 신뢰한다는 보안 모델 때문에 신뢰할 수 없는 코드는 컨테이너 안에서 다뤄야 합니다. 평점은 5점 만점에 4.2점입니다.
- Serena의 가격은 얼마입니까?
- 무료 오픈소스입니다(GPL-3.0-or-later, SolidLSP 부분은 MIT). 선택 사항인 JetBrains 플러그인은 유료이며 7일 무료 체험이 있고, JetBrains Marketplace에는 월 $5 또는 연 $50로 나와 있습니다.
- Serena의 단점은 무엇입니까?
- 2026년에 코드 실행 보안 권고가 세 건 있었고, 저장소를 신뢰한다고 가정합니다; 이동, 인라인, 디버깅에는 유료 JetBrains 플러그인이 필요합니다; 대시보드와 사용 데이터 보고가 기본으로 켜져 있습니다; 상용 제품에 넣을 때는 GPL 라이선스와 CLA가 문제가 됩니다.
- Serena에 적합한 사람은 누구입니까?
- 신뢰하는 대규모, 타입 이 있는 코드베이스나 여러 언어가 섞인 코드베이스에서 코딩 에이전트를 돌리며, 파일 간 탐색과 이름 바꾸기를 믿고 맡기고 싶은 개발자.
- 팀이나 프로덕션 환경에서 Serena의 비용은 얼마입니까?
- 언어 서버 백엔드는 팀 규모와 관계없이 무료입니다. JetBrains 플러그인은 JetBrains Marketplace에서 월 $5 또는 연 $50이며 7일 체험이 있으므로, 개발자 20명 팀은 연간 청구로 1년에 약 $1,000를 냅니다.
- Serena에 회사 데이터를 맡겨도 안전합니까?
- 사용자 권한으로 로컬에서 실행되며 파일을 수정하고 셸 명령을 실행할 수 있습니다. SERENA_USAGE_REPORTING=false가 아니면 시작할 때 익명 사용 데이터가 Oraios로 전송되고, 대시보드는 localhost:24282에서 설정과 메모리를 수정할 수 있습니다.
- Serena의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Semble, code-review-graph, GitNexus, Context7 및 CodeGraph입니다.
답변 확인일: 2026년 10월 26일.
Serena 개발사입니까? 이 평점을 사이트에 표시하십시오
