AI 보안 · 2026년 7월 10일 · 약 7분

AgentSweep 사용법: AI 코딩 에이전트 대화 기록에서 API 키와 비밀값 찾고 지우기

AgentSweep는 Claude Code, Codex, Cursor, Windsurf 같은 AI 코딩 에이전트의 로컬 기록에서 API 키와 토큰을 오프라인으로 찾고 가리는 도구입니다. 초보 개발자가 설치 전 알아야 할 한계, scan/fix/undo 명령, 키 교체 체크리스트를 정리했습니다.

• AgentSweep
• AI 코딩 에이전트 보안
• API 키 유출
• Claude Code
• Codex
• Cursor
• 로컬 기록 삭제

출처: AgentSweep GitHub README

AI 코딩 에이전트에게 “이 API 키로 테스트해 줘”라고 붙여넣은 적이 있다면, 대화 기록이나 로컬 히스토리에 비밀값이 남아 있을 수 있습니다. AgentSweep는 이런 로컬 기록을 오프라인으로 훑어 API 키, 토큰, 인증 문자열을 찾고 마스킹해 주는 오픈소스 도구예요. README 기준으로 29개 에이전트와 191개 탐지 규칙을 지원하지만 아직 alpha 단계라, 보안 보증 수단이 아니라 점검 도우미로 보는 게 맞습니다. 이미 노출된 키는 반드시 회전하고, `scan`, `fix`, `undo`, `purge`, `list-sources` 같은 명령으로 내 컴퓨터에 남은 노출 위험을 줄이는 용도로 활용해 보세요.

핵심 키워드

• AgentSweep 사용법
• AI 코딩 에이전트 기록 보안
• Claude Code Codex Cursor 비밀값 삭제
• API 키 로컬 히스토리 검사
• agentsweep scan fix undo purge
• AI agent secret redaction

출처와 맥락

• GitHub 저장소: Ishannaik/agent-sweep
• 공식 README 기준: 완전 오프라인 로컬 scan/redaction 도구로 설명됩니다.
• PyPI 패키지 agentsweep v0.1.9도 같은 요약으로 배포되어 있습니다.
• GitHub 메타데이터 기준 별 42개, 포크 7개, 2026년 7월 9일 업데이트/푸시 이력이 확인됐습니다.
• Reddit r/hacking 게시글에서는 신뢰, 오픈소스 코드 감사, 백업, 키 교체 필요성을 중심으로 토론이 이어졌습니다.

AgentSweep가 하는 일과 하지 않는 일

AgentSweep는 일반 앱 설정을 정리하는 도구가 아닙니다. 핵심은 Claude Code, Codex, Cursor, Windsurf, Aider, Gemini CLI, GitHub Copilot Chat 같은 AI 코딩 에이전트가 남긴 로컬 기록에서 secret을 찾고 가리는 것입니다. README에는 총 29개 에이전트와 191개 탐지 규칙을 지원한다고 적혀 있습니다.

먼저 알아둘 보안 원칙

가장 좋은 예방책은 API 키, 결제 키, 클라우드 토큰을 클라우드 기반 AI 에이전트 대화에 붙여넣지 않는 것입니다. 이미 붙여넣었다면 AgentSweep가 로컬 기록에 남은 흔적을 줄이는 데 도움을 줄 수 있습니다. 다만 키가 한 번 노출됐다고 의심된다면 삭제만으로 끝내지 말고 해당 키를 폐기하고 새 키로 교체해야 합니다.

초보자용 사용 순서

• 1. Python 3.11 이상이 설치되어 있는지 확인합니다.
• 2. AgentSweep GitHub 저장소와 PyPI 패키지 정보를 확인합니다. alpha 도구이므로 바로 전체 삭제부터 실행하지 않습니다.
• 3. `agentsweep list-sources`로 내 컴퓨터에서 어떤 AI 에이전트 기록을 찾을 수 있는지 봅니다.
• 4. 먼저 `agentsweep scan`으로 탐지 결과만 확인합니다.
• 5. 결과가 납득되면 백업을 만든 뒤 `agentsweep fix`로 redaction을 적용합니다.
• 6. 실수로 필요한 기록이 바뀌었다면 `agentsweep undo`를 검토합니다.
• 7. 실제로 유출됐을 가능성이 있는 API 키는 서비스 콘솔에서 폐기하고 새 키로 교체합니다.

복사해서 쓰는 명령 템플릿

명령별로 언제 쓰면 좋을까

자주 하는 실수

• AgentSweep를 실행했으니 API 키 교체가 필요 없다고 생각하는 것: 로컬 기록을 정리해도 이미 노출된 키는 폐기해야 합니다.
• 처음부터 `purge`를 실행하는 것: 초보자는 `list-sources`, `scan`, `fix` 순서로 진행하는 편이 안전합니다.
• 회사 장비에서 백업 없이 실행하는 것: alpha 도구이므로 중요한 환경에서는 테스트 폴더나 개인 장비에서 먼저 확인하세요.
• AI 에이전트 대화에 새 키를 다시 붙여넣는 것: `.env`, secret manager, 제한된 권한의 테스트 키를 쓰는 방식으로 습관을 바꿔야 합니다.
• 오픈소스 도구를 무조건 믿는 것: Reddit 토론에서도 신뢰와 코드 감사, 백업 필요성이 반복해서 언급됐습니다.

실무에서 바로 적용할 기준

개인 개발자라면 이번 주에 한 번 `scan`을 돌려보고, 오래된 OpenAI, Anthropic, GitHub, AWS, Supabase, Vercel 토큰이 발견되는지 확인해 보세요. 팀이라면 “AI 에이전트 대화에 실제 키를 붙여넣지 않는다”는 규칙을 먼저 정하고, 테스트용 키와 운영 키를 나누는 것이 출발점입니다.