
내 대화 속 착각, AI가 질문만으로 찾아줄까요? 클로드 코드 socratic-mirror 2026 소개
무료 자료
PDF · 무료
내 말 속에 깔린 전제를 질문으로 찾아주는 AI 거울 — 비개발자를 위한 쉬운 가이드
긴 글을 다 읽기 전에, 실무 가이드부터 먼저 챙겨가세요.
내 대화 속 착각, AI가 질문만으로 찾아줄까요? 클로드 코드 socratic-mirror 2026 소개
socratic-mirror는 Claude Code 대화 기록에서 내가 반복해서 깔던 전제 하나를 찾아 질문만 던지는 무료 플러그인이에요. 답이나 조언은 주지 않아요.
내가 계속 깔고 있는 전제, 스스로 알아챌 수 있을까요?
결론부터 말하면 혼자서는 꽤 어려워요. 같은 말을 여러 번 해도 내 귀에는 그냥 '지금 상황 설명'으로 들리니까요.
"왜 나는 일을 맡기고도 마음이 안 놓일까?" 이런 생각, 한 번쯤 해보셨을 거예요. 답을 찾기 전에 내가 어떤 말을 반복하는지부터 보면 도움이 될 수도 있어요. socratic-mirror는 그 부분을 맡도록 만든 플러그인이고, QJC가 오픈소스로 공개했어요.
socratic-mirror는 무엇을 하는 도구인가요?
README에 따르면 이 플러그인은 Claude Code와 나눈 지난 대화에서 "내가 반복해서 근거 없이 깔고 있는 전제"를 하나 찾아내요. 기본 범위는 현재 프로젝트의 최근 30일 대화예요. 그다음부터는 답 없이 질문만 합니다. README는 "조언도 위로도 하지 않아요"라고 적어 두었어요.
선글라스를 쓴 소크라테스가 "Know thyself."라고 말하는 socratic-mirror 저장소 타이틀 이미지
이미지 출처: github.com
내가 "그 전제가 틀렸다"고 인정하면 아포리아. 한 마디만 남기고 멈춰요. 아포리아는 답이 막혀서 더 나아갈 수 없는 상태를 뜻하는 철학 용어예요.
출처도 밝혀 둘게요. SNS에서 '하버드 교수 프롬프트'라는 별명으로 돌던 프롬프트가 있는데, 이 플러그인은 SNS에서 공유된 프롬프트 3종을 각색한 거예요. 하버드 교수가 만들었거나 쓴다는 사실은 확인되지 않았어요. 설계 문서(2026-10-02)에도 "'하버드 교수' 등 확인되지 않은 출처 문구는 쓰지 않는다"고 적혀 있습니다.
어떻게 동작하고, 대화는 어떤 모습인가요?
설계 문서(2026-10-02)에 따르면 역할이 둘로 나뉘어요. 기록에서 전제 후보를 찾는 일은 서브에이전트(premise-miner)가 하고, 질문을 던지는 대화는 메인 세션이 맡아요. 후보는 3개에서 5개이고, 후보마다 내 발화 인용이 2개 이상 붙어야 해요. 인용이 모자라면 후보에서 빠집니다. 추출 스크립트는 Python 표준 라이브러리만 써요.
아래는 README에 실린, 설명용으로 지어낸 예시예요. 실제 사용자 기록이 아니에요.
> /socrates
이 도구는 위로 없이 질문만 합니다. 원치 않으면 언제든 `그만`이라고 입력하세요.
당신은 반복해서 "혼자 해야 일이 제대로 된다"를 전제합니다.
"그냥 내가 하는 게 빨라" (2026-09-12) / "맡기면 결국 다시 해야 돼" (2026-09-20)
지난주 외주에 맡긴 일이 하루 만에 끝났을 때, 다시 손본 게 있었나요?
> ...없었어.
설계 문서는 같은 전제로 질문 10회가 지나도 진전이 없으면 "이 전제는 지금 무너지지 않습니다."라고 말하고 끝낸다고 정해 두었어요. 언제든 그만을 입력하면 바로 멈춥니다.
명령어 3개는 어떻게 다른가요?
공식 README의 사용법 표를 정리하면 이래요.
| 명령 | 하는 일 |
|---|---|
/socrates | 현재 프로젝트 최근 30일 대화에서 전제 하나를 골라 심문 |
/socrates triad | 소크라테스(반례), 공자(정명), 부처(십이연기) 세 틀로 번갈아 질문 |
/socrates close | 착각하던 것, 진짜 질문, 오늘 바꿀 행동 세 줄과 이번 주 액션 3개로 마무리 |
triad는 세 틀의 결론이 같은 지점을 가리킬 때만 삼중 아포리아.를 선언해요. 옵션도 2개 있어요. --days N으로 기간을 바꾸고(기본 30일), --all-projects로 모든 프로젝트의 대화를 대상으로 삼을 수 있어요.
설치는 어떻게 하나요?
Claude Code에서 아래 2줄을 실행하면 돼요.
/plugin marketplace add qjc-office/socratic-mirror
/plugin install socratic-mirror
Python 3.9 이상이 필요한데, README에 따르면 macOS에는 기본으로 들어 있어요.
개인정보와 안전, 한계는 어떤가요?
개인정보부터 볼게요. README에 따르면 대화 기록은 내 컴퓨터에서 로컬로 읽고, 플러그인 자체는 네트워크에 아무것도 보내지 않아요. 다만 추출된 발화는 평소 대화처럼 모델 제공자(Anthropic)로 전송돼요. Claude에게 직접 붙여넣는 것과 같다고 보시면 됩니다. API 키처럼 보이는 문자열은 가려서 넘기지만, 모든 시크릿을 잡는다고 보장하지는 않아요. 심문 로그는 ~/.socratic-mirror/log.md에 본인만 읽을 수 있는 권한(600)으로 저장되고, 추출 임시 파일은 분석이 끝나면 바로 지워져요. 전부 지우려면 ~/.socratic-mirror 폴더를 삭제하세요.
안전 쪽도 짚어 둘게요. README는 "위로 없이 질문만 하는 도구라 마음이 힘들 때는 맞지 않을 수 있어요"라고 알려요. 대화에서 위기 신호가 보이면 심문을 멈추고 도움받을 곳을 안내해요(한국은 자살예방상담 109, 24시간). 상담이나 치료를 대신하지 않아요. 이 도구가 누구에게 어떤 효과가 있는지는 확인된 바 없어요.
알려진 한계도 있어요. Claude Code 대화 기록 형식은 공개 사양이 아니라서 업데이트로 바뀔 수 있고, 기록은 있는데 추출이 0건이면 알림 후 멈춰요(종료 코드 3). 직접 붙여넣은 로그나 코드가 내 말로 잡힐 수 있고, 기간 필터는 파일 수정 시각을 먼저 보기 때문에 백업에서 복원한 오래된 세션 파일은 빠질 수 있어요.
마무리
내 말 속에 어떤 전제가 깔려 있는지 궁금하다면, 최근 30일치 기록으로 한 번 돌려볼 만해요. 질문이 불편하면 그만 한 마디로 끝낼 수 있으니 부담은 크지 않아요.
설치랑 사용법은 GitHub에 정리해뒀어요: https://github.com/qjc-office/socratic-mirror
자주 묻는 질문
무료로 쓸 수 있나요?
네, 무료예요. 라이선스는 MIT이고 저장소는 qjc-office/socratic-mirror에 공개돼 있어요. 설치 명령은 2줄이면 끝나요.
개발자가 아니어도 쓸 수 있나요?
Claude Code를 이미 쓰는 분을 대상으로 만든 플러그인이에요. 설계 문서(2026-10-02)에 대상이 "Claude Code 사용자"로 적혀 있어서, Claude Code를 쓰지 않는다면 지금은 맞지 않아요.
대화가 외부로 나가나요?
플러그인 자체는 외부 전송을 하지 않아요. 하지만 추출된 발화는 평소 대화처럼 Anthropic 모델로 전송돼요. README에 따르면 API 키 같은 문자열은 가리지만 모든 시크릿을 잡는다고 보장하지는 않아요.
하버드 교수가 만든 건가요?
플러그인은 QJC가 만들었어요. 원래 프롬프트를 하버드 교수가 만들었다는 근거는 확인되지 않았어요. SNS에서 '하버드 교수 프롬프트'라는 별명으로 돌던 프롬프트를 각색했다는 것까지만 알려져 있고, 그 별명의 출처는 확인되지 않았어요.
상담이나 치료 대신 써도 되나요?
그렇게 쓰시면 안 돼요. README는 상담이나 치료를 대신하지 않는다고 밝히고 있어요. 위기 신호가 보이면 도구가 멈추고 자살예방상담 109(24시간)를 안내해요.

