AI가 생성한 코드와 Git 커밋에서 시크릿을 지켜내는 법

AI 코딩 에이전트는 빠르지만 맹점이 하나 있다. 아무렇지 않게 API 키를 파일에 붙여 넣고, 토큰을 로그에 출력하며, 로컬에만 두려던 .env를 커밋해 버린다는 점이다. 터미널에 접근할 수 있는 모든 에이전트 — Claude Code, Cursor, Gemini CLI, Codex — 는 여러분의 셸 설정과 프로젝트 파일도 읽을 수 있는데, 바로 그곳이 자격 증명이 숨어들기 쉬운 자리다. 이 글은 시크릿을 AI가 생성한 코드와 Git 히스토리 밖에 묶어 두기 위한 실용적이고 다층적인 설정을 단계별로 안내한다.

AI 시대에 이것이 더 중요한 이유

키 유출은 소프트웨어에서 가장 흔하면서도 가장 비싼 실수 중 하나이며, AI 어시스턴트는 두 가지 측면에서 그 위험을 키운다. 첫째, 코드를 빠르게 생성하기 때문에 하드코딩된 키가 여러분이 눈치채기도 전에 수십 개 파일에 퍼질 수 있다. 둘째, 에이전트는 컨텍스트를 공격적으로 흡수한다. 한 시크릿 관리 글이 짚었듯이, 셸 설정은 키를 담아서는 안 되고 참조해야 한다. 에이전트가 여러분의 dotfile이 노출하는 것은 무엇이든 읽을 수 있기 때문이다. 해법은 도구를 불신하는 것이 아니라, 애초에 도구가 찾아낼 평문 시크릿이 하나도 없도록 만드는 것이다.

1단계: 시크릿은 코드가 아니라 환경 변수에 둔다

기본 원칙은 이렇다. 어떤 API 키, 비밀번호, 토큰도 소스 코드에 문자열 리터럴로 등장해서는 안 된다. 프로젝트 루트의 .env 파일에 넣고 런타임에 읽어 들여라.

# .env  — never committed
ANTHROPIC_API_KEY=sk-ant-...
DATABASE_URL=postgres://...

// app.js — reads from the environment, no secret in the file
const apiKey = process.env.ANTHROPIC_API_KEY;

이렇게 하면 여러분(그리고 여러분의 AI 에이전트)이 편집하는 코드에는 시크릿의 이름만 담기고, 그 값은 결코 담기지 않는다.

2단계: .env가 절대 커밋되지 않도록 한다

시크릿을 단 한 줄이라도 쓰기 전에 먼저 .gitignore에 추가하라.

.env
.env.local
*.env

대신 빈 자리표시자가 들어간 .env.example을 커밋해서, 협업자가 어떤 변수를 설정해야 하는지 알 수 있게 하라.

ANTHROPIC_API_KEY=
DATABASE_URL=

이미 진짜 .env를 커밋했다면, 새 커밋에서 그것을 지우는 것만으로는 충분하지 않다. 히스토리에 남아 있기 때문이다. 노출된 키를 즉시 교체하고, 이미 탈취된 것으로 간주하라.

3단계: GitHub 푸시 보호 기능을 켠다

GitHub의 푸시 보호 기능은 푸시하는 순간 커밋을 스캔해, 시크릿을 발견하면 푸시를 차단함으로써 유출이 원격 저장소에 도달하기 전에 막아 준다. 이 기능은 AWS, OpenAI, Stripe 등 여러 제공업체의 200가지가 넘는 시크릿 패턴을 인식하며, 2026년 업데이트로 기본 차단 패턴이 더 늘어났다. 공개 저장소에서는 무료이니, 저장소의 Settings → Code security에서 켜라. 에이전트(또는 여러분)가 실수하는 그 순간을 위한 안전벨트라고 생각하면 된다.

4단계: 에이전트가 셸 설정을 긁어 가지 못하게 한다

셸에 접근할 수 있는 에이전트는 .zshrc, .bashrc, .zshenv를 읽을 수 있다. 편의를 위해 그곳에 키를 export해 두었다면 에이전트가 그것을 볼 수 있다. 기기 전역 시크릿을 dotfile 밖에 두어라. 셸을 시작할 때 평문으로 export하는 대신, 필요할 때 시크릿 매니저나 OS 키체인에서 불러오도록 하라.

5단계: 권한을 좁히고 주기적으로 교체한다

무언가 실제로 유출되더라도 피해를 줄여 주는 두 가지 습관이 있는데, 이는 OpenAI의 API 키 안전 가이드에서도 강조하는 조언이다.

• 최소 권한: 각 키에 필요한 만큼의 가장 좁은 범위만 부여하고, 프로젝트와 환경마다 별도의 키를 써서 한 번의 유출이 모든 것을 노출하지 않도록 하라.
• 정기적 교체: 키를 정해진 주기로 교체하고, 노출이 의심되는 즉시 교체하라. 교체된 키는 침해를 아무 일 아닌 것으로 만든다.

간단 체크리스트

에이전트를 저장소에 풀어 놓기 전에 확인하라.

1. 시크릿은 .env에 있고 process.env로 읽는다 — 절대 하드코딩하지 않는다.
2. .env는 .gitignore에 있고, .env.example만 커밋된다.
3. 원격 저장소에 푸시 보호가 켜져 있다.
4. 셸 dotfile에 평문 키가 없다.
5. 키는 범위가 좁고, 정해진 주기로 교체된다.

이 모든 것은 한번 설정해 두면 작업 속도를 전혀 늦추지 않는다. 오히려 훨씬 적은 걱정으로 더 많은 일을 AI 에이전트에게 넘길 수 있게 해 준다.