Kodus 이라는 에이전트를 중심으로 한 오픈 소스 코드 검토 플랫폼입니다. Kody. 풀 요청 차이점과 컨텍스트를 분석하고, 기본 제공 및 팀 정의 규칙을 적용하고, 제안을 필터링하고, Git 제공자에 인라인 결과 또는 요약을 게시합니다. 현재 프로젝트 자료에는 GitHub, GitLab, Bitbucket 및 Azure Repos가 나열되어 있으며 상태 반응은 현재 GitHub 및 GitLab에서 더 풍부합니다.
Kodus은 책임 있는 유지 관리자, 결정론적 정적 분석기 또는 변경이 안전하다는 증거가 아닌 초기의 반복 가능한 검토자로서 유용합니다. 버그, 성능 문제, 보안 냄새 및 정책 위반을 발견할 수 있지만 시스템 간 동작을 놓치거나 의도를 오해하거나 그럴듯한 오탐지를 생성할 수도 있습니다. 보호된 지점, 테스트, 전문 스캐너 및 인간 소유권이 여전히 필요합니다.
검토 경로 및 신뢰 경계
PR 이벤트 / 매뉴얼 @kody 명령어
|
v
Git 공급자 앱 ---> diff + 선택한 컨텍스트
|
v
Kodus 제어 평면/자체 호스팅 서비스
|
.------+---.
v v
선택한 LLM 규칙/메모리/플러그인
| |
'--------- 찾기 ------'
|
중복 제거 + 심각도 + 보호 장치
|
v
인라인 댓글/요약/선택적 검토 상태
|
CI + 검토자 -> 병합 결정
선택한 버전에 대해 이 흐름을 매핑합니다. 호스팅된 Kodus, 클라우드 모델의 자체 호스팅 Kodus, 온프레미스 모델의 자체 호스팅 Kodus에는 서로 다른 데이터 경로가 있습니다. "자체 호스팅"은 메시지가 계속 외부 공급자에게 전달되는 경우 코드가 네트워크 내부에 유지된다는 의미는 아닙니다.
에디션 및 비용 모델
현재 저장소 비교에는 Community, Teams 및 Enterprise 버전이 나열되어 있습니다. 커뮤니티는 고객의 자체 모델 키, 최대 10개의 Kody 규칙 및 최대 3개의 활성 플러그인을 사용할 때 무제한 PR이 포함된 무료, 사용 가능한 호스팅 또는 자체 호스팅으로 표시됩니다. Teams는 개발자당 월 $10 또는 연간 청구 시 개발자당 월 $8에 모델/토큰 비용이 추가됩니다. Enterprise는 맞춤형이며 SSO, RBAC/감사 및 지원과 같은 영역을 추가합니다. 패키징이 변경되므로 실시간 비교를 확인하세요.
| 선택 | 플랫폼 수수료 | 모델 청구 | 운영 소유권 |
|---|---|---|---|
| 커뮤니티 호스팅 + BYOK | 현재 무료로 등록되어 있습니다. | 선택한 제공업체에 직접 연결 | 키, 저장소 권한 및 정책 |
| 자체 호스팅 커뮤니티 + BYOK | 저장소 약관에 따라 무료로 나열된 소프트웨어 | 직접 공급자 또는 로컬 인프라 | 전체 배포, 스토리지, 보안 및 업그레이드 |
| 팀 | 개발자당 수수료 | BYOK/토큰 비용 별도 | 구성, 공급자 및 검토 거버넌스 |
| 기업 | 맞춤 | 계약된 토큰 배열 확인 | 계약 중인 공급업체와 공유됨 |
저장소는 BYOK에 대한 모델 비용에 대한 제로 마크업을 장려하지만 비용은 여전히 차이 크기, 상황별 파일, 파일 간 분석, 선택한 모델, 재시도 및 후속 커밋에 따라 달라집니다. 가격 문서에는 변경된 파일이 200개가 넘는 PR은 검토되지 않는다고 나와 있습니다. PR당 비용이 아닌 승인된 문제당 비용을 계산하세요.
모델 선택은 검토 정책 선택입니다.
Kodus은 Claude, GPT, Gemini, Llama, GLM, Kimi 및 OpenAI 호환 엔드포인트를 포함하여 모델에 구애받지 않는 지원을 광고합니다. 코드베이스에서 정확한 공급자와 모델을 벤치마킹하세요. 더 저렴한 모델은 리뷰어가 봇을 무시할 정도로 많은 오탐지를 생성할 수 있습니다. 강력한 모델은 비례적인 결함 감소 없이 더 많은 컨텍스트와 비용을 노출할 수 있습니다.
| 기준 | 측정 | 왜 중요한가요? |
|---|---|---|
| 참양성 정밀도 | 승인된 유효한 결과/모든 결과 | 낮은 정밀도는 리뷰어의 신뢰를 파괴합니다. |
| 시드 결함에 대한 리콜 | 알려진 결함 발견/삽입된 결함 | 침묵은 안전의 증거가 아니다 |
| 심각도 교정 | 인간 루브릭과의 계약 | 차단은 심각도에 따라 다릅니다. |
| 교정 노력 | 검증하고 수정하는 데 몇 분 밖에 걸리지 않습니다. | 장황하고 정확한 코멘트는 여전히 비용이 많이 들 수 있습니다 |
| 비용 | 공급자 토큰 + 플랫폼 + 검토 인력 | API 가격만 표시되지 않고 착륙 비용만 표시됩니다. |
| 대기 시간 | 유용한 피드백을 위한 PR 업데이트 | 느린 검토가 흐름을 방해합니다. |
권한: 봇이 봐야 하는 내용만 검토하세요.
기본적으로 전체 조직이 아닌 선택한 저장소에 Git 공급자 앱을 설치합니다. 코드/메타데이터에 대한 읽기 액세스 권한과 리뷰 댓글/상태를 게시할 수 있는 권한으로 시작하세요. 별도로 정당화된 기능에서 요구하지 않는 한 관리, 비밀, 환경, 릴리스 또는 직접 쓰기를 부여하지 마십시오.
리포지토리 코드에는 실수로 발생한 자격 증명, 고객 설비, 독점 알고리즘 및 개인 데이터가 포함될 수 있습니다. 차이점과 컨텍스트만 전송되더라도 해당 조각은 민감할 수 있습니다. 공급자 유지/교육 조건, 지역, 암호화, 하위 처리자 및 삭제를 검토합니다. 프로젝트에 따르면 소스 코드는 모델을 훈련하는 데 사용되지 않으며 전송 및 저장 시 암호화됩니다. 선택한 호스팅 및 공급자 경로에 대한 계약 범위를 확인합니다.
자체 호스팅은 아키텍처 작업을 제거하지 않습니다.
공식 배포 자료에는 API, 웹후크, 작업자 및 웹 서비스, 데이터베이스/큐, AST 그래프/파일 간 분석 샌드박스가 설명되어 있습니다. 샌드박스는 작업자 내부의 로컬이거나 유료 원격 옵션인 E2B일 수 있습니다. Cloud Git 통합에는 공개 웹 및 API 엔드포인트가 필요합니다. 내부 Git과 온프레미스 모델은 외부 인터넷 없이도 작동할 수 있습니다.
| 자체 호스팅 구성 요소 | 위험 | 제어 |
|---|---|---|
| 웹훅 엔드포인트 | 이벤트 위조/재생 및 서비스 거부 | 서명 검증, 재생 방어 및 속도 제한 |
| 노동자 | 신뢰할 수 없는 코드 구문 분석 및 리소스 고갈 | 컨테이너/VM 샌드박스, 할당량 및 제한된 송신 |
| 데이터베이스/큐 | 코드/컨텍스트 및 토큰 유출 | 암호화, 인증, 백업 및 보관 |
| 모델 엔드포인트 | 프롬프트/코드 공개 및 비용 남용 | 범위가 지정된 키, 허용 목록에 있는 엔드포인트 및 저장소별 예산 |
| 웹 애플리케이션 | 구성 및 저장소 인계 | SSO/MFA, RBAC, CSRF 보호 및 감사 |
| 원격 측정 | 예상치 못한 외부 메타데이터 | 익명의 하트비트를 검토합니다. 필요한 경우 문서화된 설정을 통해 비활성화 |
저장소에는 자체 호스팅 인스턴스가 매일 하나의 익명으로 집계된 하트비트와 문서를 전송한다고 명시되어 있습니다. KODUS_TELEMETRY_DISABLED=참 선택 해제합니다. 고정된 버전에서 이를 검증하고 아웃바운드 트래픽을 모니터링합니다.
먼저 경고하고 나중에 차단
Kody의 기본값은 제안입니다. 문서에서는 중요한 결과에 대한 선택적인 "변경 요청"을 허용하고 문제가 발견되지 않은 경우 자동 승인을 허용합니다. 적어도 몇 주 동안 자문을 시작하십시오. 측정된 정밀도가 높고 명확한 수정 및 재정의 경로가 있는 규칙에 대해서만 차단을 활성화합니다. AI 결과가 없다는 것을 유일한 자동 승인 조건으로 사용하지 마십시오.
| 정책 | 적합한 초기 사용 | 필수 동반 증거 |
|---|---|---|
| 댓글만 | 모든 파일럿 저장소 | 수락/해제 사유 추적 |
| 중요한 변경 요청 | 안정적인 고정밀 보안/성능 규칙 | 휴먼 오버라이드 및 결정론적 스캐너/테스트 |
| 자동 승인 | 성숙한 벤치마크 이후 위험도가 낮은 문서/테스트 | 보호된 CI 및 다른 병합 인증 |
| 필수 상태 확인 | 잘 관리되는 저장소 | 긴급 수정을 중단할 수 없는 시간 초과/실패 정책 |
코드로서의 규칙에는 적용되는 것과 동일한 검토가 필요합니다.
Kody 규칙은 범위, 경로 및 심각도와 함께 팀 표준을 인코딩할 수 있습니다. 리포지토리 규칙은 문서화된 디렉터리 아래에 있을 수 있으며, 중앙 집중식 구성은 버전 기록, PR 검토 및 롤백을 통해 하나의 리포지토리를 조직의 정보 소스로 만들 수 있습니다. 이는 문서화되지 않은 UI 드리프트보다 바람직하지만 악의적이거나 실수로 규칙을 변경하면 많은 저장소에 영향을 미칠 수 있습니다.
- 중앙 집중식 규칙 변경에는 CODEOWNERS의 승인이 필요합니다.
- 롤아웃 전에 포지티브 및 네거티브 픽스처에 대한 규칙을 테스트합니다.
- 카나리아는 저장소의 하위 집합이며 댓글 양을 비교합니다.
- 모든 규칙에 소유자, 근거, 예시, 만료/검토 날짜 및 재정의 경로를 제공합니다.
- "깨끗한 코드 작성"과 같은 모호한 규칙을 피하세요. 관찰 가능한 실패를 지정합니다.
기억과 학습은 나쁜 피드백을 보존할 수 있습니다
Kodus은 Kody을 학습 팀 컨텍스트로 지정합니다. 기억은 반복되는 잘못된 긍정을 줄일 수 있지만 검토자의 의견은 틀렸거나 냉소적이거나 프로젝트별로 다를 수 있습니다. 학습된 지침의 출처와 범위를 기록하고 삭제를 허용하며 오래된/상충되는 기억을 주기적으로 검토합니다. 개발자가 한 가지 발견 사항을 무시했다고 해서 보안 정책을 조용히 다운그레이드해서는 안 됩니다.
MCP 및 플러그인으로 검토 범위 확장
맞춤형 플러그인은 MCP 또는 기타 통합을 통해 동적 표준을 가져올 수 있습니다. 내부 레지스트리, 문제 추적기 또는 문서를 모델에 노출할 수 있으며 프롬프트 주입 경로가 될 수 있습니다. 허용 목록 도구 및 방법, 읽기 전용 자격 증명 사용, 출력 유효성 검사, 플러그인 콘텐츠가 시스템 검토 정책보다 우선하지 않도록 방지합니다.
커뮤니티 비교에서는 현재 활성 플러그인이 제한되어 있지만 상위 계층에는 무제한이 나열됩니다. "무제한"은 디자인 목표가 아닙니다. 각 플러그인은 데이터 액세스 및 유지 관리 부담을 정당화해야 합니다.
대규모 및 생성된 풀 요청
PR을 작게 유지하고 사양에 연결하세요. 문서에 따르면 Kody은 변경된 파일을 검토하고, PR 수준/파일 간 검사를 수행하고, 제안을 필터링 및 중복 제거할 수 있으며, 증분 후속 조치를 위해 마지막으로 분석된 커밋을 기억합니다. 차이가 매우 크면 AI와 인간의 이해력이 모두 저하되며 문서화된 200개 파일 제한을 초과할 수 있습니다.
생성된 마이그레이션, 잠금 파일 및 공급업체 자산을 로직 변경으로 분할합니다. 무시 패턴을 구성하되 무결성이 배포에 영향을 미치는 생성된 아티팩트를 숨기지 마세요. 녹색 상태가 전체 적용 범위로 잘못 읽히지 않도록 건너뛴 파일 요약과 검토 제한을 요구합니다.
발견 항목을 검증하는 방법
| 발견 유형 | 신뢰할 수 있는 검증 | 일반적인 거짓양성 |
|---|---|---|
| 버그 | 잘못된 동작을 보여주는 재현/테스트 | 리뷰어가 다른 곳에서 불변성을 놓쳤습니다. |
| 보안 | 위협 경로와 전문 스캐너/수동 분석 | 신뢰할 수 있는 경계에서 입력이 이미 검증되었습니다. |
| 성능 | 현실적인 데이터에 대한 벤치마크/프로파일 | 핫패스 증거가 없는 미세 최적화 |
| 스타일/유지관리성 | 버전이 지정된 팀 규칙 | 결함으로 제시된 주관적 선호 |
| 누락된 테스트 | 위험/행동 적용 범위 지도 | 다른 레이어에도 동일한 적용 범위가 있습니다. |
| 획기적인 변화 | API/스키마 호환성 확인 | 의도적인 버전 중단 |
영향을 받는 행동, 증거, 심각도 및 제한된 제안의 이름을 지정하려면 인라인 주석이 필요합니다. 잘못된, 관련성이 없는, 중복된, 허용된 위험, 지연된 등의 구조화된 이유를 바탕으로 종료하므로 데이터 튜닝을 실행 가능하게 할 수 있습니다.
AI 에이전트가 융합을 자체적으로 검토하도록 하지 마세요.
코딩 에이전트가 검토를 실행하고 문제를 수정하고 반복하는 보관된 레거시 Kodus CLI 승격 루프입니다. 이는 로컬적으로 도움이 될 수 있지만 동일한 모델이 자체 가정을 생성하고 승인할 수 있습니다. 또한 테스트를 약화시키거나 진동할 수도 있습니다. 반복, 토큰, 시간 및 차이 크기 한도를 설정합니다. 다른 읽기 전용 검토자와 최종 독립 CI를 사용합니다.
참고하세요 Kodutech/cli 현재 Kodus 문서와 유지 관리되는 패키지 경로를 확인하지 않고 설치 프로그램이나 명령을 기반으로 새 워크플로를 기반으로 하지 마세요.
6주간의 출시
- 1주차: 보안/데이터 검토; 최소한의 권한으로 두 개의 저위험 저장소를 연결합니다.
- 2~3주차: 조언적인 의견만; 모든 결과에 라벨을 붙이고 정확성을 측정합니다.
- 4주차: 5~10개의 구체적인 규칙을 추가하고 과거 PR과 비교하여 테스트하세요.
- 5주차: 동일한 숨겨진 PR 세트에서 두 모델을 비교하고 착륙 비용을 계산합니다.
- 6주차: 정밀도 및 재정의 작업이 목표를 충족하는 경우에만 좁게 정의된 하나의 차단 규칙을 활성화합니다.
검토자 시간 절약, 댓글 100개당 승인된 결과, 결함 탈출, 첫 번째 응답 대기 시간, 공급자 비용, PR 리드 타임 및 개발자 감정을 추적합니다. 기술적으로 그럴듯한 댓글을 많이 게시하지만 병합 처리량을 늦추는 봇은 성공하지 못합니다.
대안
| 옵션 | 최적의 핏 | Kodus과의 절충 |
|---|---|---|
| Kodus/Kody | 모델 선택, 규칙 및 호스팅/자체 호스팅 유연성 | 작동/구성 표면 및 진화하는 패키징 |
| GitHub Copilot 코드 검토 | GitHub 기반 팀은 이미 라이선스를 받았습니다. | 공급자/호스팅 유연성 감소 |
| CodeRabbit | 풍부한 통합을 통한 관리형 PR 검토 | 상업용 호스팅 종속성 |
| 코도 머지 | PR 검토 및 테스트 중심 워크플로 | 다양한 정책 및 가격 모델 |
| Semgrep/소나/스니크 | 결정적 정적/보안 규칙 | 자연어 컨텍스트가 적고 재현성이 향상됨 |
| 휴먼 코더너 리뷰 | 아키텍처, 비즈니스 의도 및 책임 | 전문가의 시간이 부족합니다. 자동화를 보완해야 한다 |
자주 묻는 질문
Kodus은 오픈 소스인가요?
기본 저장소는 공개되어 있으며 커뮤니티 자체 호스팅을 설명합니다. 배포에 대한 현재 라이센스 파일 및 버전 조건을 검토하십시오.
내 모델 키를 사용할 수 있나요?
예, 현재 자료에서는 BYOK 및 여러 모델 공급자/OpenAI 호환 엔드포인트를 광고합니다.
Kodus이 내 코드에서 학습되나요?
프로젝트 상태 소스 코드는 교육에 사용되지 않습니다. 계약과 별도의 기본 모델 제공자의 조건을 확인하세요.
Kody이 풀 요청을 차단할 수 있나요?
선택적으로 구성된 중요 문제에 대한 변경을 요청할 수 있습니다. 정밀 테스트 후에만 활성화하고 사람이 재정의하도록 유지합니다.
자동 승인이 가능한가요?
문서에는 선택적 자동 승인이 설명되어 있지만 결과가 없다는 것이 정확성을 증명하는 것은 아닙니다. 독립적인 CI 및 병합 인증이 필요합니다.
어떤 리포지토리가 지원되나요?
현재 자료에는 GitHub, GitLab, Bitbucket 및 Azure Repos가 나열되어 있습니다. 일부 인터페이스 동작은 다릅니다.
매우 큰 PR이 지원됩니까?
가격 책정 문서에서는 변경된 파일이 200개를 초과하는 엄격한 제한을 보고합니다. PR이 작을수록 리뷰 품질도 향상됩니다.
1차 소스
- 공식 Kodus 저장소, 에디션 및 아키텍처
- 실시간 Kodus 가격
- 공식 코드 검토 흐름
- 공식 검토/차단 정책
- 중앙 집중식 구성 가이드
- 공식 셀프 호스팅 가이드
- 공식 가격 및 한도 설명
- GitHub App 보안 모범 사례
- OWASP 애플리케이션 보안 참조
2026년 7월 26일에 최종 검토되었습니다. Kodus 계획, 모델 지원, CLI 경로 및 기능이 빠르게 발전합니다. 배포된 버전을 고정하고 리포지토리에 대한 개인 정보 보호, 권한, 비용 및 정확성을 확인하세요.
