클로드 코드 CLI에서 잘 안 쓰는 명령 여덟 개

클로드 코드를 매일 쓰면서도 실제로 치는 건 claude 하나뿐인 경우가 많습니다. 그런데 공식 명령 목록을 끝까지 읽어보니 서른 개가 넘게 있더군요. 그중 알면 확실히 쓸모 있는데 잘 안 알려진 여덟 개를 골랐습니다. 다른 코딩 도구 설정을 통째로 가져오는 명령, 백그라운드로 돌려둔 세션에 붙었다 떼는 명령, 그리고 로컬에 쌓인 기록을 진짜로 지우는 명령까지요.

📌 30초 요약

• 코덱스나 제미나이 설정을 가져오는 명령이 있습니다. 미리보기 옵션도 함께요.
• 백그라운드 세션은 붙이고·보고·멈추고·다시 살리고·목록에서 빼는 다섯 명령으로 다룹니다.
• 목록에서 뺀다고 대화가 지워지진 않습니다. 기록은 남고 나중에 이어갈 수 있습니다.
• 진짜로 지우려면 따로 있는 정리 명령을 써야 합니다. 되돌릴 수 없으니 미리보기부터.
• 세션 안 진단과 터미널 진단은 이름이 같아도 하는 일이 다릅니다.
• 일부는 버전 요구가 있어 안 보일 수 있습니다.

① 다른 도구 설정 가져오기

제일 놀란 명령입니다. 다른 코딩 에이전트에 해둔 설정을 클로드 코드로 옮겨오는 명령이 따로 있습니다. 인자로 코덱스나 제미나이를 지정하면 대화형 세션이 열려서 가져오기를 진행합니다.

미리보기 옵션이 있다는 게 중요합니다. 무엇을 가져올지 먼저 보고 결정할 수 있으니, 도구를 갈아타는 중이라면 손으로 옮기기 전에 이걸 먼저 돌려보는 편이 낫습니다. 두 도구를 저울질하는 글을 예전에 쓴 적이 있는데, 그때는 "옮기려면 설정을 다시 잡아야 한다"가 갈아타기의 비용이었습니다. 그 비용이 줄어든 셈입니다.

⚠️ 안 되는 환경이 따로 있습니다

이 명령은 클라우드 제공사 위에서 돌리는 구성에서는 제공되지 않습니다. 그리고 기능 플래그를 받아오지 않도록 설정해뒀다면 역시 안 뜹니다. 회사 환경에서 안 보인다면 버전 문제가 아니라 구성 자체가 대상이 아닌 경우일 수 있습니다.

②~⑥ 백그라운드 세션 다섯 명령

일을 시켜놓고 자리를 뜨는 방식으로 쓰면 세션이 여러 개 굴러다니게 됩니다. 그걸 터미널에서 다루는 명령이 다섯 개 있습니다. 폰에서 내 세션에 이어 붙는 기능을 쓰신다면 이쪽도 같이 알아두면 손이 편합니다.

하는 일	설명	눈여겨볼 점
붙기	돌고 있는 세션에 이 터미널로 접속	아이디만 알면 어디서든
보기	최근 출력만 찍어보기	붙지 않고 상태만 확인
멈추기	세션 중지	다른 이름으로도 같은 동작
다시 살리기	돌든 멈췄든 대화를 그대로 두고 재시작	전체 옵션으로 새 버전 물리기
목록에서 빼기	목록에서만 제거	대화 기록은 그대로 남음

네 번째가 특히 쓸모 있습니다. 문서가 용도를 콕 집어 적어뒀는데, 클로드 코드를 업데이트한 뒤 돌고 있는 세션들을 새 버전으로 갈아끼우는 데 쓰라고 합니다. 전체 옵션을 붙이면 실행 중인 세션을 한 번에 처리합니다. 대화 내용은 유지되고요.

다섯 번째는 이름 때문에 오해하기 쉽습니다. 목록에서 지운다고 대화가 없어지는 게 아닙니다. 기록은 로컬에 그대로 남아서 이어가기 명령으로 다시 열 수 있습니다. 화면을 정리하는 용도지 삭제가 아닙니다.

⑦ 진짜로 지우는 명령

그럼 진짜 삭제는 어디에 있느냐. 프로젝트 단위로 로컬 상태를 통째로 지우는 명령이 따로 있습니다. 문서가 지우는 대상을 하나씩 열거해뒀습니다.

# 지워지는 것 — 프로젝트 하나의 로컬 상태 전부
· 대화 기록          · 작업 목록
· 디버그 로그        · 파일 편집 이력
· 프롬프트 입력 기록  · 전역 설정 안의 그 프로젝트 항목

# 반드시 미리보기부터 (되돌릴 수 없음)
$ claude project purge ~/work/repo --dry-run

# 경로를 빼면 목록에서 고를 수 있고,
# 하나씩 확인하며 지우는 옵션과 전체를 지우는 옵션도 있습니다

파일 편집 이력까지 들어간다는 게 눈에 띕니다. 되돌리기용으로 쌓아둔 기록이라, 지우고 나면 이전 상태로 돌아가는 경로 하나가 사라지는 셈입니다. 미리보기 옵션이 괜히 있는 게 아닙니다.

⑧ 이름이 같은데 다른 진단

진단 명령이 두 개인데 이름이 같습니다. 하나는 터미널에서 바로 치는 것이고, 하나는 세션 안에서 슬래시로 부르는 것입니다. 하는 일이 다릅니다.

어디서	무엇을	고치기
터미널에서	설치 상태, 설정 파일 오류, 원격 제어 가능 여부	읽기만 함
세션 안에서	설정 점검	고치기도 함

쓰임이 갈리는 지점이 분명합니다. 세션을 켤 수 없는 상황이거나 스크립트에서 상태만 확인하고 싶을 때는 터미널 쪽입니다. 특히 설정 파일에 잘못 적힌 항목을 짚어준다는 게 쓸모 있는데, 자동화로 돌리면 화면 경고를 못 보고 지나치기 쉽거든요.

🧹 자동 승인 규칙을 들여다보고 되돌리기

덤으로 하나 더. 매번 묻는 걸 줄여주는 자동 모드가 어떤 기준으로 판단하는지 내장 규칙을 통째로 뽑아 볼 수 있습니다. 라벨 앞부분으로 걸러서 보는 옵션도 있어서, 위험한 작업 분류만 골라 읽을 수 있습니다. 손대다 꼬였다면 기본값으로 되돌리는 명령도 따로 있는데, 하나 알아둘 게 있습니다 — 되돌려도 조직이 내려준 규칙은 그대로 남습니다. 이 명령이 건드리는 건 내 사용자 설정 안의 해당 항목뿐입니다. 확인을 한 번 묻고 진행하니, 스크립트에서 돌릴 땐 확인 생략 옵션이 필요합니다.

🔗 명령이 아니라 말로 부르는 것도 있습니다

잘 안 쓰는 명령 여덟 개를 모아 뒀는데, 명령줄에 없고 말로 시켜야 되는 일도 있습니다. 끝난 하위 에이전트를 이어서 쓰는 것이 그렇습니다 — 같은 이름을 다시 불러도 새 인스턴스가 뜰 뿐이라, 「그 검토를 이어서 해 줘」처럼 이어 가라고 말해야 앞선 이력을 들고 다시 돕니다. ★그러면 도구 묶음과 데워 둔 캐시까지 그대로 따라옵니다. 이 글에 정리한 명령으로 세션을 다루는 요령은 그대로 유효하고, 명령이 없는 자리에서 쓸 방법이 하나 더 있는 셈입니다.

자주 묻는 질문

Q. 명령을 쳤는데 없다고 나옵니다.

여기 적은 것 중 몇 개는 특정 버전 이상에서만 동작합니다. 가져오기 명령과 자동 모드 관련 명령이 그렇습니다. 먼저 업데이트를 한 번 돌려보시고, 그래도 없으면 환경 자체가 대상이 아닌 경우를 의심하세요. 클라우드 제공사 위에서 돌리는 구성이나 기능 플래그를 꺼둔 환경에서는 아예 제공되지 않는 명령이 있습니다.

Q. 백그라운드 세션이 응답을 안 합니다.

세션들을 관리하는 감독 프로세스가 따로 있습니다. 상태를 찍어보는 명령이 있고, 돌지 않으면 실패로 끝나니 스크립트에서 판정에 쓸 수 있습니다. 멈춰야 한다면 세션은 살려두고 감독만 내리는 옵션이 있습니다 — 다음에 뜨는 감독이 그 세션들에 다시 붙습니다. 세션까지 같이 내리면 하던 일이 끊기니, 복구가 목적이라면 이 옵션을 쓰는 게 맞습니다.

Q. 자동화 스크립트에서 로그인은 어떻게 하나요?

CI나 스크립트용으로 오래 쓰는 토큰을 만드는 명령이 있습니다. 구독이 있어야 하고, 화면에 출력만 하고 어디에도 저장하지 않습니다. 그러니 받는 즉시 안전한 곳에 넣어야 합니다 — 터미널 기록에 남지 않게 처리하는 것까지 포함해서요. 이런 값은 블로그나 저장소에 절대 올리지 마세요. 다른 꿀팁은 터미널 사용 팁 정리 글에 모아뒀습니다.

🧾 정직하게 밝혀둡니다

• 공식 명령 목록을 읽고 정리한 내용이고, 여덟 개를 전부 직접 실행해보지는 않았습니다. 특히 삭제 계열은 되돌릴 수 없어 시험하지 않았습니다.
• ★명령 이름과 옵션 철자는 본문에서 일부러 한글로 풀었습니다. 버전에 따라 달라질 수 있어, 실제로 칠 때는 도움말이나 공식 레퍼런스에서 확인하세요.
• 버전 요구가 붙은 명령이 있습니다. 본문에 정확한 버전 번호를 적지 않은 건, 이 글을 읽는 시점에는 이미 지난 이야기일 가능성이 커서입니다.
• ★목록 자체가 계속 바뀝니다. 바로 오늘도 문서 색인에서 항목 하나가 빠지고 셋이 새로 생겼습니다. 여기 없는 명령이 이미 있을 수 있습니다.
• 삭제 계열은 미리보기 옵션을 먼저 쓰세요. 지운 뒤에 되돌릴 방법은 안내돼 있지 않습니다.

✨ 정리하면

목록에서 빼기와 진짜 지우기가 다른 명령이라는 것, 그리고 도구를 갈아탈 때 설정을 가져올 수 있다는 것 — 이 둘만 알아둬도 값을 합니다. 오늘 한 번 도움말을 끝까지 스크롤해 보세요. 저처럼 안 써본 게 몇 개는 나올 겁니다. AI 도구 설정과 비용은 AI 지출 정리 허브에 모아뒀습니다.

출처: Claude Code 공식 문서 CLI reference (2026-08-24 확인). 명령·옵션·버전 요구사항은 업데이트에 따라 변경될 수 있습니다. 이 글은 정보 제공용입니다.