Search

Search through articles and snippets by title, tags, or content.

Back to Articles
claude code cli history 남기지 않는 방법
DevClaudeCodeCodexCLIPrivacy

claude code cli history 남기지 않는 방법

Codex CLI와 Claude Code CLI는 대화 기록을 로컬 파일에 저장하지만, 기록을 끄는 방법은 서로 달라요. 프롬프트 입력 기록과 세션 기록의 차이부터 각 CLI의 설정 방법, 기존 기록 삭제까지 정리했습니다.

D
DevBlog
Oct 25, 2026
3 min read

Codex CLI와 Claude Code CLI는 모두 대화 기록을 로컬 파일에 저장할 수 있어요. 하지만 기록을 비활성화하는 설정 방식은 서로 다릅니다. 두 도구에서 기록을 남기지 않는 방법을 차례로 살펴볼게요.

먼저 다음 두 종류의 기록을 구분해야 해요.

  • 명령어 입력 기록: 과거에 입력한 프롬프트를 다시 불러오기 위한 기록 (history.jsonl 등)
  • 세션 기록: 대화 내용, 도구 실행 결과, 작업 상태 등을 저장하는 기록

history.jsonl 저장만 중지하려는 것인지, 모든 대화 기록을 저장하지 않으려는 것인지에 따라 설정이 달라집니다.

1. Codex CLI 설정

공식 지원되는 방법이에요. 설정 파일 ~/.codex/config.toml에 다음 내용을 추가하세요.

[history]
persistence = "none"

설정 방법 (macOS)

터미널에서 다음 명령어를 실행합니다.

nano ~/.codex/config.toml

위 설정을 추가하고 Control + O → Enter → Control + X 순서로 저장합니다.

Codex CLI를 재실행하면 이후 history.jsonl에 새로운 프롬프트가 저장되지 않아요. 단, ~/.codex/sessions/에 저장되는 별도 세션 기록까지 중지하는 설정은 아닙니다.

2. Claude Code CLI 설정

이것도 공식 지원되는 방법이에요. Claude Code는 환경변수를 사용합니다.

export CLAUDE_CODE_SKIP_PROMPT_HISTORY=1

이후 같은 터미널에서 claude를 실행하면 프롬프트 기록과 세션 트랜스크립트의 디스크 저장을 건너뜁니다.

macOS에서 영구 적용하기

nano ~/.zshrc

파일 마지막에 다음 내용을 추가합니다.

export CLAUDE_CODE_SKIP_PROMPT_HISTORY=1

저장 후 적용합니다.

source ~/.zshrc

이 설정을 사용한 세션은 --resume, --continue 및 위쪽 화살표의 과거 기록에서 사용할 수 없게 돼요.

3. 두 CLI 비교

구분Codex CLIClaude Code CLI
설정 방식TOML 파일환경변수
history.jsonl 저장 중지가능가능
세션 전체 기록 중지별도 방법 필요해당 환경변수로 가능
기존 기록 자동 삭제안 됨안 됨

4. 기존 history.jsonl 삭제

기존에 저장된 기록까지 삭제하고 싶다면, 먼저 CLI를 종료한 후 실행하세요.

# Codex CLI
rm -f ~/.codex/history.jsonl
 
# Claude Code CLI
rm -f ~/.claude/history.jsonl

이 명령은 해당 파일만 삭제하며, 별도 세션 폴더에 저장된 기록은 삭제하지 않아요.

마무리

프롬프트 입력 기록만 저장하지 않으려면 Codex는 persistence = "none"을 사용하세요. Claude Code는 공식 환경변수가 세션 기록까지 중지하므로, 기존 세션 이어하기 기능을 사용하는 경우 주의가 필요해요.

두 도구 모두 설정을 적용하기 전에 진행 중인 세션을 종료하는 것이 좋습니다.

Comments