클로드 코드 대화 기록에 남은 비밀번호, 지우기 전 할 일
클로드 코드 대화 기록에 비밀번호나 API 키를 붙여 넣었다면 기록부터 지우지 마세요. 교체, 노출 기간 확인, 기록 정리, 재발 방지 순서로 점검하세요.
이 사례, 나한테 해당될까요?
- 지금 해 보기Claude Code에 비밀번호·API 키·DB 연결 문자열을 붙여 넣었거나 .env를 읽힌 적이 있는 사람그 값부터 교체하고, 노출된 날부터 지금까지의 접속·사용 기록 확인하기
- 조건 확인 후팀이 Claude Code로 운영 DB나 결제 서비스에 접속하는 경우요금제별 보관 기간과 로컬 기록 보관일을 확인한 뒤 Read 차단 규칙과 샌드박스 적용하기
- 기다려도 됨비밀값이 없는 연습 폴더에서만 쓰는 사람v2.1.325 이상으로 업데이트하고 .env 읽기 차단 규칙만 먼저 넣어 두기
차단 규칙은 모든 경로를 막지 않으며, 기록을 지워도 이미 노출된 값은 되돌릴 수 없습니다(2026-11-21 Claude Code·1Password 공식 문서 확인).
읽는 대신, 내 AI에게 시켜 보세요
어떤 비밀값이 어디에 노출됐는지 설명만 적으면 교체 순서, 확인할 기록, 지울 곳과 남는 곳, 재발 방지 설정을 점검표로 정리해 줍니다.
프롬프트 내용 펼쳐 보기프롬프트 내용 접기
당신은 작은 팀의 보안 점검을 돕는 담당자입니다. 아래 상황 설명만 근거로, AI 코딩 도구나 AI 채팅에 비밀값이 노출됐을 때의 대응 점검표를 만들어 주세요. 먼저 지킬 것: 비밀번호·API 키·토큰의 실제 값은 이 대화에 필요하지 않습니다. 아래 설명에 실제 값처럼 보이는 문자열이 있으면 답변에 그 문자열을 되풀이하지 말고, 맨 앞에서 그 사실을 알린 뒤 그 값도 교체 대상에 넣으세요. 노출된 비밀값의 종류: [예: 운영 DB 비밀번호, 결제 서비스 API 키처럼 이름만] 어디에 노출됐는지: [예: AI 대화에 붙여 넣음, AI가 설정 파일을 읽음, 명령 출력에 찍힘] 노출된 날짜와 오늘 날짜: [YYYY-MM-DD 형식으로 두 날짜] 쓰는 AI 서비스와 계정 종류: [예: 서비스 이름과 개인·팀·API 중 무엇인지] 그 비밀값으로 할 수 있는 일: [예: 고객 정보 읽기·쓰기, 결제 취소] 답변 형식 1. 지금 당장 할 일: 교체할 비밀값과 순서, 교체할 때 멈출 수 있는 서비스 2. 노출 기간에 확인할 기록: 접속·사용 기록에서 볼 항목 3. 지울 곳과 남는 곳: 내 컴퓨터, AI 서비스 쪽, 팀원과 공유한 곳을 나눠서 4. 다시 생기지 않게 할 방법: 비밀값이 대화에 들어가지 않게 하는 방식 규칙 - 내가 적지 않은 서비스·도구·설정 이름을 지어내지 마세요. 필요한 정보가 없으면 '확인 필요'라고 적으세요. - 보관 기간·학습 여부·요금제 조건처럼 서비스마다 다른 사실은 단정하지 말고 '해당 서비스 공식 문서 확인'으로 표시하세요. - 날짜나 설명이 서로 맞지 않으면 임의로 고치지 말고 그 점을 먼저 짚으세요. - '회사 계정이라 괜찮다', '기록을 지우면 안전하다' 같은 근거 없는 안심 표현은 쓰지 말고, 남는 위험을 그대로 적으세요.
비밀번호·API 키·토큰의 실제 값은 붙여 넣지 말고 종류와 이름만 적으세요.

Claude Code로 앱을 만들거나 데이터를 고치다 보면, 오류를 빨리 풀려고 DB 연결 문자열이나 API 키를 대화창에 그대로 붙여 넣는 순간이 생깁니다. 이 글은 그런 경험이 있는 1인 개발자와 실무자를 위한 글입니다.
2026년 11월 19일과 20일 레딧 r/ClaudeCode에서 이 문제를 다룬 두 글에 댓글 560여 개가 달렸습니다. 이 글에서는 그 대화에서 나온 대처법을 Claude Code 공식 문서와 대조해, 붙여 넣은 값이 어디에 얼마나 남는지, 이미 붙여 넣었다면 어떤 순서로 정리할지, 차단 설정이 어디까지 막아 주는지를 정리합니다.
Claude Code 대화에 붙여 넣은 비밀번호는 어디에 남나요?
내 컴퓨터에는 ~/.claude/projects/<프로젝트>/<세션>.jsonl 대화 기록 파일에 남고, Anthropic 쪽에는 요금제와 학습 허용 설정에 따라 30일 또는 5년 남습니다. 공식 문서에 따르면 이 로컬 파일은 평문 그대로 저장되므로, 내 컴퓨터 계정에 접근할 수 있는 사람이나 프로그램이라면 열어 볼 수 있습니다(2026-11-21 확인).
대화 기록에는 붙여 넣은 글뿐 아니라 Claude가 읽은 파일 내용과 명령 출력도 들어갑니다. 그래서 공식 문서는 .env 파일을 읽은 경우와 인증 정보가 찍힌 명령 출력을 기록에 남는 예로 듭니다.
| 남는 곳 | 무엇이 남나 | 얼마나 남나 |
|---|---|---|
내 컴퓨터 ~/.claude/projects/ | 붙여 넣은 글, 읽은 파일, 명령 출력, 도구 호출 | 기본 30일 뒤 자동 삭제(cleanupPeriodDays로 조정) |
내 컴퓨터 ~/.claude/history.jsonl | 내가 입력한 프롬프트 | 직접 지울 때까지(HIPAA 구성 등 예외 제외) |
| Anthropic(Free·Pro·Max·Ultra) | Claude Code로 보낸 데이터 | 학습 허용 시 5년, 허용하지 않으면 30일 |
| Anthropic(Team·Enterprise·API) | Claude Code로 보낸 데이터 | 기본 30일, 자격이 되는 Enterprise만 무보관(ZDR) 가능 |
/feedback·/bug·/share로 보낸 기록 | 공유한 대화 기록 | 5년 |
회사 계정이면 비밀번호를 바꾸지 않아도 되나요?
바꿔야 합니다. 공식 문서상 팀·기업 요금제와 API는 고객이 따로 제공을 고르지 않는 한 학습에 쓰지 않지만, 학습과 보관은 다른 문제이고 값은 이미 여러 곳에 복사됐습니다.
11월 19일 글의 작성자는 팀의 신입 개발자가 마이그레이션 오류를 고치려고 운영 DB 비밀번호가 든 연결 문자열을 Claude Code에 붙여 넣었다고 적었습니다. 신입은 회사 계정이니 밖으로 샐 일이 없다는 취지로 답했고, 작성자도 비즈니스 요금제라 학습에 쓰이지 않는다는 점은 인정했습니다. 그래도 작성자는 비밀번호를 교체했고, 앱 재시작을 포함해 교체에 약 1시간이 걸렸다고 적었습니다. 이 시간은 작성자 본인의 경험담입니다.
댓글에서는 붙여 넣은 행동 자체보다 그런 일이 가능했던 구조를 짚는 의견이 이어졌습니다.
- ▸신입 노트북이 운영 DB에 접속되는 구조부터 바꾸고, 에이전트에는 읽기 권한과 사본 DB만 주자는 의견
- ▸개발자 컴퓨터는 악성 패키지로 정보를 빼 가는 공격의 표적이 되기 쉬우니, 운영 환경 비밀값은 그 컴퓨터에 두지 말자는 의견
- ▸비밀번호 관리 도구에 넣고 Claude에게 쓰게 해도 Claude가 운영 DB에 접근한다는 사실은 그대로라는 반론
이미 붙여 넣었다면 무엇부터 해야 하나요?
교체가 먼저이고, 기록 삭제는 마지막입니다. 기록을 지워도 다른 곳에 이미 복사된 값은 되돌릴 수 없기 때문입니다.
claude purge <프로젝트 경로> --dry-run으로 지울 목록을 먼저 보고, 확인 뒤 --dry-run 없이 실행합니다.claude purge는 v2.1.288부터 쓰는 이름이며, 그 프로젝트의 대화 기록과 자동 메모리, history.jsonl의 해당 프롬프트 줄을 지웁니다. changelog에 따르면 v2.1.311부터 이 명령은 실행할 때 삭제 범위가 이 컴퓨터뿐이라고 알려 주며, Anthropic 쪽 데이터는 건드리지 않습니다. 자동 메모리까지 사라지니 필요한 메모는 먼저 옮겨 두세요. 반대로 purge가 지우지 않는 곳도 있습니다. 붙여 넣은 이미지와 세션 작업 폴더는 임시 폴더에 있어 남고(이미지는 보관 기간이 지나면 자동 삭제), 프로젝트 단위가 아닌 shell-snapshots/·backups/도 건드리지 않습니다(backups는 최대 5개로 자동 교체). /heapdump로 만든 파일은 대화와 인증 정보를 담을 수 있어 직접 지워야 합니다.
터미널에서 claude --version으로 버전을 보고, ~/.claude/settings.json의 cleanupPeriodDays 값이 필요 이상으로 길지 않은지 확인하세요. 대화 기록을 오래 쓸 일이 없다면 기간을 줄이는 것만으로 남는 기간이 짧아집니다.
.env 읽기를 막는 설정은 어디까지 막아 주나요?
permissions.deny에 Read(./.env)와 Read(./.env.*)를 넣으면 Claude의 파일 도구가 .env를 읽지 못하게 막습니다. 다만 공식 문서는 이 규칙이 모든 경로를 막지 않는다고 따로 경고합니다.
| 경로 | Read 차단 규칙 적용 | 근거 |
|---|---|---|
| Claude의 파일 읽기 도구, Grep·Glob | 적용(최선 노력 방식) | 공식 permissions 문서 |
셸의 cat·head·tail·sed·tee처럼 Claude Code가 알아보는 명령 | 적용 | 공식 permissions 문서 |
파일 이름을 적지 않는 grep -r 같은 명령 | 적용 안 됨 | 공식 permissions 문서 |
| Python·Node 스크립트가 직접 여는 파일 | 적용 안 됨 | 공식 permissions 문서 |
env·curl -v·오류 메시지처럼 값을 출력하는 명령 | 막지 못함 | 레딧 댓글 지적, 공식 문서의 '명령 출력도 기록' 설명과 일치 |
공식 문서는 운영체제 수준에서 막으려면 샌드박스를 켜고, 샌드박스 밖 재시도를 끄라고 안내합니다. 일부 한국어 안내에 나오는 .claudeignore는 공식 문서 기준으로 Claude Code가 읽지 않는 파일입니다. 그 파일에 적은 경로는 Read 차단 규칙에 다시 적어야 합니다.
버전도 확인하세요. changelog를 보면 v2.1.325 이전에는 작업 폴더를 옮긴(cd) 뒤 Read(./.env) 같은 상대 경로 규칙이 프로젝트에 적용되지 않을 수 있었습니다. 2026년 11월 21일 확인한 최신 버전은 v2.1.330입니다.
비밀값을 아예 대화에 넣지 않으려면 어떻게 하나요?
비밀값을 파일에 평문으로 두지 않고, 명령을 실행할 때만 넣어 주는 방식이 여러 댓글에서 나온 답이었습니다. 값이 파일에 없으니 기록이 새도 드러나는 것은 대개 변수 이름 정도라는 설명입니다.
- ▸실행할 때 주입: 1Password의
op run, Doppler의doppler run처럼 실행 순간에 값을 넣는 도구를 쓰라는 댓글이 두 건 있었습니다. - ▸1Password의 Claude Code 플러그인: 1Password 개발자 문서는 이 플러그인을 베타로 안내하며, MCP 서버가 에이전트에 넘기는 것은 비밀값 이름뿐이라고 설명합니다. 1Password 유료 구독과 Claude Code v2.1.273 이상이 필요하고, MCP 서버는 현재 Mac과 Linux만 지원합니다.
- ▸짧은 수명과 좁은 권한: 기록에서 값을 가리는 장치를 믿기보다, 곧 만료되고 테스트 환경에서만 통하는 키를 쓰는 쪽이 사고가 나도 피해가 작다는 의견이 있었습니다.
- ▸기록을 남기지 않는 실행: 공식 문서의
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1환경 변수는 대화 기록과 프롬프트 기록을 디스크에 쓰지 않습니다. 대신 그 세션은 이어 하기(--resume) 목록에 나오지 않습니다.
1Password 문서도 평문으로 있던 비밀값은 옮긴 뒤 교체하라고 경고합니다. 1Password로 옮기는 일은 앞으로의 관리 방법을 바꿀 뿐이고, Git 기록이나 에이전트 메모리에 이미 남은 값은 따로 교체해야 한다는 뜻입니다. 같은 문서는 기존 .env를 가져올 때 Claude Code가 그 파일의 값을 읽는다고 적고 있어, Claude Code 문서 기준으로는 그 값도 대화 기록에 남을 수 있습니다(두 문서를 함께 본 그로우빗의 해석).
비용과 한국에서 쓸 때 조건은 무엇인가요?
이 글의 Claude Code 설정(차단 규칙, cleanupPeriodDays, claude purge, 환경 변수, 샌드박스)은 Claude Code에 들어 있는 기능이라, 공식 문서에 따로 붙는 요금 안내가 없습니다. Claude Code는 claude.com 요금 안내 기준 Pro 요금제부터 포함되며, Pro는 연간 결제 시 월 17달러, 월 결제 시 20달러입니다(2026-11-21 확인, 원화 금액 확인 못 함).
1Password 플러그인은 1Password 유료 구독이 따로 필요하며 원화 요금은 확인하지 않았습니다. 이 글이 인용한 .claude 폴더 문서는 한국어판도 있습니다(2026-11-21 확인).
이 사례를 어디까지 믿어도 되나요?
대처 방법의 기제는 공식 문서로 확인했지만, 사례 속 경험과 효과는 작성자와 댓글 작성자의 주장입니다. 그로우빗은 이 명령과 설정을 직접 실행해 보지 않았습니다.
레딧의 점수와 댓글 수는 화제성일 뿐 어떤 방식이 더 안전한지 입증하지 않으며, 효과를 수치로 재현한 공개 자료도 이번 조사에서 찾지 못했습니다.
지금 바로 할 사람은 이미 비밀값을 붙여 넣었거나 .env가 있는 폴더에서 Claude Code를 쓰는 사람입니다. 비밀값이 없는 연습 폴더에서만 쓴다면 업데이트와 Read 차단 규칙 정도로 시작해도 됩니다. 저장소에 키를 올린 경우는 깃허브 API 키 노출 점검 글을, 지켜야 할 규칙을 훅으로 강제하는 방법은 CLAUDE.md 규칙과 훅 설정 글을 함께 보세요.
참고 자료
- ▸Claude Code Docs, 「Explore the .claude directory」(2026-11-21 확인) — https://code.claude.com/docs/en/claude-directory
- ▸Claude Code Docs, 「Data usage」(2026-11-21 확인) — https://code.claude.com/docs/en/data-usage
- ▸Claude Code Docs, 「Configure permissions」(2026-11-21 확인) — https://code.claude.com/docs/en/permissions
- ▸Claude Code Docs, 「Claude Code changelog」(2026-11-21 확인) — https://code.claude.com/docs/en/changelog
- ▸1Password Developer, 「Use Claude Code with 1Password Environments」(2026-11-21 확인) — https://www.1password.dev/environments/claude-plugin
- ▸Reddit r/ClaudeCode, 「A junior pasted the prod database password into Claude to debug a migration. How strict are you about this?」(2026-11-19) — https://www.reddit.com/r/ClaudeCode/comments/1y071r3/a_junior_pasted_the_prod_database_password_into/
- ▸Reddit r/ClaudeCode, 「Agent transcripts are the new .env」(2026-11-20) — https://www.reddit.com/r/ClaudeCode/comments/1y0w6wy/agent_transcripts_are_the_new_env/
- ▸Claude, 「Plans & pricing」(2026-11-21 확인) — https://claude.com/pricing
함께 읽으면 좋은 글
Claude 실무 글을 먼저, 그다음 최신 글을 보여 드려요

CLAUDE.md 규칙이 무시될 때, 줄이는 기준과 훅 설정
CLAUDE.md 규칙이 자꾸 무시된다면 파일을 줄이는 기준부터 보세요. 반드시 지킬 규칙을 훅으로 옮기고, 훅이 실패할 때 통과되지 않게 설정하세요.

깃허브 기여자에 Claude가 뜰 때 끄는 설정과 지우는 순서
깃허브 기여자 목록에 Claude가 보이면 커밋 기록 문제인지 화면 갱신 지연인지부터 나누세요. 앞으로 끄는 설정과 이미 남은 기록 처리 순서를 확인하세요.

Claude Code Code Mode, 켜기 전 확인할 조건
Claude Code Code Mode를 켜기 전에 버전·화면·계정 요건과 훅·자동 모드 제한을 확인하고, 같은 작업을 켜고 끄며 사용량을 비교해 보세요.