AI가 쓴 코드, 보내기 전 질문부터 던지는 도구 Sphinx

개발자 parthh01이 AI의 도움으로 쓴 코드를 개발자가 제대로 이해했는지 묻는 오픈소스 도구 Sphinx를 공개했다. 10월 18일 해커뉴스에 소개됐다. 이 도구는 코드를 공유 저장소로 보내는 ‘푸시’ 직전에 질문을 던진다. 저장소에 적힌 버전은 0.1이다.

코드를 보내기 전 무엇을 묻나

Sphinx는 기본 설정에서 main과 master로 코드를 보낼 때 전송을 멈춘다. 둘은 프로젝트의 주 작업 갈래다. 이때 Git이 특정 작업 전후에 알아서 실행해 주는 ‘훅’ 기능을 쓴다. 검토를 맡은 별도 AI가 저장된 코드 변경 내용을 읽고 질문을 만든다. 이 코드가 어떻게 동작하는지, 어떤 상황에서 실패하는지를 묻는다. 검토 AI는 개발자가 코드를 쓸 때 AI와 나눈 대화는 보지 못한다.

답이 틀리면 설명과 함께 새로운 상황을 다시 제시한다. 질문을 통과하면 멈췄던 전송을 이어 간다. 건너뛰기를 고르면 답하지 않고 바로 보낼 수도 있다. 이때는 통과로 기록되지 않는다. 기본 설정에서 처음 묻는 질문은 작은 변경에 최대 1문항, 큰 변경에 최대 3문항이다. 저장소 설명에 따르면 이 숫자는 상한이어서, 물어볼 내용이 적으면 질문도 그만큼 줄어든다. 틀린 답이 나오면 같은 개념을 묻는 질문이 하나 더 붙어서, 전체 질문 수가 상한을 넘을 수 있다. 통과 기록은 24시간 동안 유효하다. 코드와 전송 목적지, 검사 정책이 그대로일 때만 그렇다.

기존 검사와 무엇이 다른가

푸시 직전에 특정 작업을 실행하는 Git 기능은 전부터 있었다. Sphinx는 여기에 개발자의 이해를 묻는 과정을 붙였다. 비슷한 도구 sphinx-ci는 코드 변경을 합쳐 달라고 요청하는 ‘풀 리퀘스트’ 단계에서 퀴즈를 내고, 합치기 전에 확인하도록 안내한다. Sphinx는 개발자 컴퓨터에서 코드를 보내기 전에 묻는다.

검사 범위도 그 차이에 맞춰져 있다. 버전 0.1은 개발자 컴퓨터에서 이뤄지는 저장과 전송만 다룬다. 웹에서 진행되는 코드 합치기나 자동 검사, 배포는 다루지 않는다. 저장소 안내는 훅을 건너뛸 수 있고 검토 AI도 틀릴 수 있다고 설명한다. 질문을 통과해도 코드가 안전하다거나 개발자가 혼자 이해했다는 증명은 되지 않는다고 덧붙였다.

누가 쓰고 비용은 얼마나 드나

설치하려면 Git과 Node.js 22.19 이상이 필요하다. macOS와 Linux에서 쓸 수 있고, Windows에서는 리눅스 환경(WSL)을 거쳐야 한다. Sphinx가 직접 운영하는 계정이나 서비스는 없다. 검토를 맡길 AI 모델을 직접 연결해야 한다. 로그인한 Codex나 Claude 명령줄 도구, OpenRouter 접속 키를 쓸 수 있다.

도구는 오픈소스지만 검토를 맡길 모델은 직접 마련해야 한다. 로그인한 Codex나 Claude 요금제를 쓰면 그 요금제의 사용 한도가 줄어든다. OpenRouter는 무료 모델을 쓸 때도 접속 키가 필요하고, 유료 모델은 요금이 따로 청구된다. 기본 설정에는 모델 호출 횟수 상한이 없다. 문서는 보통 한 번 검토에 5~8회를 호출하고, 답변마다 1회가 더 붙는다고 안내한다.

Sphinx는 AI가 쓴 코드를 공유하기 전에 개발자가 동작과 실패 상황을 설명하게 만든다. 실제로 도입하려면 검토에 드는 시간과 비용을 먼저 따져 볼 만하다. 검토에 들어간 코드와 답변은 개발자가 지정한 검토 모델 쪽으로 전송된다. 업무용 코드라면 이 점도 함께 고려해야 한다.