클로드 코드 프롬프트 제안 — 기본은 꺼짐·깃 기록에서 골라오는 예시

세션을 처음 열면 입력창에 흐린 글씨로 예시 명령이 하나 떠 있습니다. 그리고 클로드가 답을 마치고 나면 「다음엔 이걸 해 보시죠」 같은 제안이 붙기도 하고요. 얼핏 같은 기능처럼 보이지만 출처도 다르고 켜지는 조건도 다릅니다.

더 헷갈리는 건 사람마다 보이고 안 보이고가 갈린다는 점입니다. 「나는 그런 제안 본 적 없는데」 하는 분이 많은데 우연이 아닙니다 — 대화형 모드에서는 기본이 꺼짐이고, 켜 둬도 건너뛰는 자리가 여섯 군데나 됩니다. 어디서 오고 언제 안 뜨는지 하나씩 갈라 보겠습니다.

📌 30초 요약

• 첫 화면의 예시는 프로젝트 깃 기록에서 골라옵니다.
• 답변 뒤 제안은 기본이 꺼짐이라 안 보이는 게 정상입니다.
• 켜 둬도 캐시가 식으면 건너뜁니다.
• 환경 변수가 설정 파일보다 앞섭니다.

1. 첫 화면의 흐린 예시는 어디서 오나

세션을 열자마자 보이는 흐린 예시부터 봅시다. 이건 아무 문장이나 골라 넣는 게 아니라 지금 프로젝트의 깃 기록에서 뽑아옵니다. 그래서 최근에 손댄 파일들이 예시에 반영되고, 저장소를 옮겨 다니면 예시도 따라 바뀝니다. 「무슨 말부터 해야 하지」 싶을 때 출발점을 주려는 장치인데, 실은 이 한 줄만 봐도 클로드가 이 폴더를 어떻게 파악하고 있는지가 얼핏 드러납니다. 예시에 엉뚱한 파일이 등장한다면 작업 폴더를 잘못 잡은 건 아닌지 의심해 볼 만합니다.

두 번째 장치는 성격이 다릅니다. 클로드가 답을 마친 뒤 대화 흐름을 보고 다음 프롬프트를 제안하는 건데, 여러 단계로 나뉜 요청의 다음 단계라든가 지금 작업의 자연스러운 이어짐 같은 것을 내놓습니다. 받아 쓰려면 탭이나 오른쪽 화살표를 눌러 입력창에 채운 뒤 엔터를 치면 되고, 그냥 다른 걸 타이핑하기 시작하면 알아서 사라집니다. 눌러야만 들어가니 실수로 엉뚱한 요청이 나갈 일은 없습니다.

비용이 걱정되실 텐데 이쪽은 안심해도 됩니다. 제안은 배경 요청으로 따로 만들어지지만 대화의 프롬프트 캐시를 그대로 재사용합니다. 같은 대화를 다시 읽히는 게 아니라 이미 데워 둔 것을 쓰기 때문에 추가로 드는 값이 미미합니다. 뒤에서 보겠지만 이 성질 때문에 캐시가 식은 순간에는 제안을 아예 안 만듭니다. 캐시가 언제 깨지는지는 프롬프트 캐싱이 깨지는 순간에 정리해 뒀습니다.

2. 기본이 꺼져 있습니다

여기가 가장 많이 오해받는 지점입니다. 대화형 모드에서 제안 기능은 기본으로 꺼져 있습니다. 그러니 안 보이는 게 고장이 아니라 정상 상태입니다. 게다가 어떤 세션에서는 설정 화면의 토글 자체가 숨겨져서, 켜려고 해도 항목을 찾을 수 없습니다. 「분명 문서에 있는데 내 설정엔 없다」는 상황이 여기서 생깁니다. 토글이 숨는 조건이 정해져 있으니 아래 표로 확인하시는 게 빠릅니다.

토글이 숨는 경우	설명
타사 제공자 경유	기능 스위치를 받아오지 못하는 세션
앱 게이트웨이 경유	같은 이유로 항목이 안 보임
설치·판올림 직후	첫 세션은 스위치가 아직 안 도착

⚠️ 설치 직후 첫 세션은 권한 모드까지 다릅니다

표의 마지막 줄이 특히 중요합니다. 새로 깔거나 판을 올린 뒤 첫 세션에서는 스위치로 열리는 기능이 통째로 빠질 수 있습니다. 그런데 영향이 제안에만 그치지 않습니다 — 원래 자동 모드로 시작하는 요금제인데도 그 세션만 수동 모드로 시작할 수 있습니다. 클로드 코드가 그 세션 동안 스위치를 받아 오므로 다음 세션부터는 둘 다 정상으로 돌아옵니다. 판을 올린 직후 「왜 매번 물어보지」 싶으면 고장을 의심하기 전에 세션을 한 번 다시 여세요.

한 가지 더 갈리는 자리가 있습니다. 여러 명이 함께 일하는 에이전트 팀에서는 팀원 쪽 세션에서 제안이 기본으로 꺼집니다. 반면 이끄는 쪽 세션에서는 제안이 나옵니다. 같은 팀에서 같은 판을 쓰는데 한쪽만 보인다면 이 차이 때문입니다. 설정을 아무리 맞춰도 역할이 다르면 결과가 다를 수 있으니, 팀 단위로 쓰실 때는 이 점을 미리 공유해 두시는 편이 혼선을 줄입니다.

3. 켜 둬도 건너뛰는 자리

설정을 켰다고 매번 나오는 것도 아닙니다. 문서가 개별 제안을 건너뛰는 상황을 여러 개 적어 뒀는데, 공통점을 보면 쓸데없는 값을 치르지 않으려는 판단과 제안이 오히려 방해가 되는 상황으로 나뉩니다. 앞엣것의 대표가 캐시가 식었을 때고, 뒤엣것의 대표가 계획 모드입니다. 한 번 훑어 두면 「왜 오늘은 안 뜨지」에 답이 됩니다.

건너뛰는 상황	이유
캐시가 식음	불필요한 비용을 피하려고
직전 응답이 오류	이어갈 맥락이 온전하지 않아서
계획 모드 중	계획을 세우는 흐름을 안 끊으려고
한도에 가까움	남은 한도를 아끼려고 — 환경 변수로 유지 가능

표의 마지막 줄에는 우회로가 있습니다. 한도가 가까워져도 제안을 계속 받고 싶다면 전용 환경 변수를 켜 두면 한도에 실제로 닿을 때까지 유지됩니다. 다만 옛 판에서는 이 변수를 켜 둬도 한도 근처에서 그냥 건너뛰었으니, 안 먹는 것 같으면 판 번호부터 확인하세요. 표에 없는 경우도 하나 있는데, 대화의 첫 차례 직후에는 일부 세션에서 제안이 안 붙습니다.

대화 없이 한 번에 돌리는 인쇄 모드는 아예 다릅니다. 기본으로는 제안을 만들지 않고, 전용 플래그와 특정 출력 형식을 함께 줘야 차례마다 제안 메시지가 따로 나옵니다. 자동화 파이프라인에서 제안을 수집하려는 경우에 쓰는 방식이죠. 다만 여기서도 아주 짧은 대화와 식은 캐시는 똑같이 건너뛰므로, 짧은 질문 하나만 던지면 제안이 한 건도 안 나올 수 있습니다.

4. 끄는 세 가지와 우선순위

반대로 제안이 거슬려서 끄고 싶을 수도 있습니다. 방법이 세 가지인데 설정 화면의 토글, 설정 파일의 항목, 그리고 환경 변수입니다. 어느 쪽을 써도 결과는 같지만 환경 변수가 설정 파일보다 앞섭니다. 설정 파일에 켜 두고도 안 켜진다면 셸 어딘가에 변수가 남아 있는 건 아닌지 보세요. 설정이 어느 파일에 어떻게 적히고 무엇이 무엇을 이기는지는 설정 키 지도에 따로 정리해 뒀습니다.

조직 단위로 끌 때는 한 단계가 더 필요합니다. 관리형 설정에 항목을 꺼짐으로 적는 것만으로는 부족한데, 구성원이 자기 환경 변수로 다시 켤 수 있기 때문입니다. 그래서 문서는 관리형 설정의 환경 항목에도 같은 변수를 꺼짐으로 넣으라고 안내합니다. 설정과 환경 변수를 한 벌로 묶어야 비로소 잠긴다는 뜻이고, 이 구조는 다른 기능을 조직 차원에서 통제할 때도 그대로 적용됩니다.

마지막으로 판단 기준을 정리하면 이렇습니다. 제안은 캐시를 재사용하니 값이 거의 안 들고, 눌러야만 들어가니 사고를 만들지도 않습니다. 그러니 기본이 꺼짐이라는 걸 알고도 안 켜 둘 이유는 적은 편입니다. 다만 계획 모드를 자주 쓰거나 한도에 자주 닿는 사용 습관이라면 어차피 안 뜨는 자리가 많으니 체감이 작을 수 있습니다. 대화를 늘리지 않고 옆에서 묻는 방법은 곁가지 질문에, 도입 순서 전체는 AI 도입 한 바퀴에서 잡아 보세요.

자주 묻는 질문 (FAQ)

Q. 설정에서 해당 항목을 못 찾겠습니다

토글이 숨겨진 세션일 가능성이 큽니다. 타사 제공자나 앱 게이트웨이를 거치는 세션처럼 기능 스위치를 받아오지 못하는 환경에서는 항목 자체가 안 보입니다. 설치하거나 판을 올린 직후 첫 세션도 마찬가지고요. 이 경우는 세션을 한 번 다시 열면 해결됩니다. 그래도 안 보이면 설정 파일에 항목을 직접 적거나 환경 변수를 쓰세요.

Q. 켰는데도 제안이 안 뜹니다

건너뛰는 상황에 걸린 겁니다. 캐시가 식었거나, 직전 응답이 오류로 끝났거나, 계획 모드거나, 한도에 가까운 경우가 대표적입니다. 대화의 첫 차례 직후에도 일부 세션에서는 안 붙고요. 한도 근처에서도 계속 받고 싶다면 전용 환경 변수를 켜 두면 됩니다 — 단 옛 판에서는 그래도 건너뛰었으니 판 번호를 함께 보세요.

Q. 제안 때문에 요금이 더 나오나요?

거의 안 늘어납니다. 제안은 배경 요청으로 만들어지지만 대화의 프롬프트 캐시를 그대로 재사용해서, 같은 내용을 다시 읽히지 않습니다. 오히려 캐시가 식은 상태에서는 아예 만들지 않는데, 그 자리에서는 값이 커지기 때문입니다. 비용을 이유로 꺼 둘 필요는 크지 않다고 보셔도 됩니다.

Q. 회사 전체에서 끄려면요?

관리형 설정에 항목을 꺼짐으로 적되, 관리형 환경 항목에도 같은 변수를 꺼짐으로 넣어야 합니다. 그렇게 하지 않으면 구성원이 자기 환경 변수로 다시 켤 수 있습니다 — 환경 변수가 설정보다 앞서기 때문입니다. 설정과 환경 변수를 한 벌로 묶는 이 방식은 다른 기능을 조직 차원에서 잠글 때도 똑같이 쓰입니다.

정리하면

• 첫 화면 예시는 깃 기록에서 골라옵니다.
• 답변 뒤 제안은 기본이 꺼짐입니다.
• 설치 직후 첫 세션은 권한 모드까지 다를 수 있습니다.
• 캐시가 식으면 알아서 건너뜁니다.
• 조직에서 잠그려면 환경 항목까지 함께 막으세요.

※ 공개된 대화형 모드 문서와 환경 변수 문서를 읽고 정리했습니다. 설정 항목과 변수 이름은 우리말로 풀어 적었으니 실제 입력값은 원문에서 확인하세요.

※ 기본값과 건너뛰는 조건은 판올림에 따라 달라질 수 있습니다. 본문에서 「옛 판」으로 뭉친 부분은 문서에 판 번호로 적혀 있으니, 지금 쓰는 판과 원문을 대조해 확인하세요.