예쁜 화면이 막고 있던 것

요즘 터미널 도구는 화면을 예쁘게 그립니다. 테두리를 두르고, 돌아가는 표시를 띄우고, 같은 자리에 글자를 계속 덮어쓰면서 진행 상황을 보여주죠. 그런데 이 방식이 화면을 소리로 읽어주는 프로그램에는 정반대로 작동합니다. 공식 변경점에 그 예쁜 화면을 전부 걷어내는 모드가 들어왔길래 무엇을 어떻게 바꾸는지 확인해봤습니다. 같은 주에 세션이 끝없이 도는 걸 막는 숫자도 함께 들어왔습니다.

📌 30초 요약

① 박스·회전 표시·제자리 덮어쓰기를 전부 없애고 평범한 줄글로만 출력합니다.

② 각 줄에 무엇을 말하는 줄인지 이름표가 붙어 순서대로 읽힙니다.

③ 켜는 방법이 세 가지입니다. 이번 세션만, 이 터미널만, 아니면 항상.

④ 웹 검색과 곁가지 작업에 각각 200번 상한이 걸렸습니다. 끝없이 도는 걸 막으려고요.

⑤ 외부 도구 호출이 2분을 넘기면 자동으로 뒤로 넘어갑니다. 세션이 안 멈추게요.

⑥ 오래 걸리는 작업에 경과 시간이 흐릅니다. 멈춘 건지 도는 건지 구분됩니다.

왜 예쁜 화면이 방해가 되나

화면을 소리로 읽어주는 프로그램은 글자를 위에서 아래로 순서대로 읽습니다. 그런데 요즘 터미널 도구는 같은 자리를 계속 고쳐 그리는 방식으로 진행 상황을 표시합니다. 회전하는 표시 하나가 1초에도 여러 번 바뀌죠.

보통 화면	낭독 프로그램 입장
테두리 박스로 구역을 나눔	기호가 잔뜩 읽힘
회전 표시로 "도는 중"을 알림	계속 바뀌니 계속 읽음
같은 자리를 덮어써서 갱신	방금 읽은 곳이 사라짐
승인 창이 화면 가운데 뜸	어디를 봐야 하는지 알기 어려움

세 번째 줄이 특히 큽니다. "방금 읽어준 자리가 다시 덮어써지는" 상황에서는 내용을 끝까지 따라갈 수가 없습니다. 눈으로 보면 자연스럽게 갱신되는 화면이, 소리로 들으면 계속 처음으로 돌아가는 셈이 됩니다.

걷어내면 이렇게 됩니다

새 모드는 화면을 그리는 방식을 통째로 바꿉니다. 박스도 회전 표시도 제자리 갱신도 없이, 이름표가 붙은 평범한 줄을 위에서 아래로 쌓습니다. 그러면 낭독 프로그램이 순서대로 읽어 내려갈 수 있고, 권한을 허락하는 것도 결과를 확인하는 것도 처음부터 끝까지 가능해집니다.

# 켜는 방법 세 가지

# 1) 이번 세션만 — 실행할 때 옵션 하나
claude --ax-screen-reader

# 2) 이 터미널에서 계속 — 환경 변수
CLAUDE_AX_SCREEN_READER

# 3) 어디서나 — 설정 파일
axScreenReader

# 세 단계로 나눠둔 게 핵심입니다
  잠깐 써보고 → 이 창에서만 → 마음에 들면 항상

켜는 방법을 세 단계로 나눠둔 것이 눈에 띕니다. 접근성 기능을 설정 깊숙이 하나만 두는 대신, 한 번 써보는 것부터 늘 쓰는 것까지 단계를 만들어뒀습니다. 낭독 프로그램을 쓰지 않더라도 터미널 출력을 그대로 파일로 남기고 싶을 때 쓸모가 있는 구조입니다.

끝없이 돌지 않게 박아둔 숫자

같은 주 변경점에 성격이 다른 항목이 하나 더 있었습니다. 한 세션에서 웹 검색과 곁가지 작업이 각각 200번을 넘지 못하게 상한이 걸렸습니다. 목적이 명시돼 있습니다 — 제자리에서 끝없이 도는 상황을 막기 위해서입니다.

🔁 왜 상한이 필요했을까

AI에게 "될 때까지 해봐"라고 맡기는 방식이 늘었습니다. 잘 돌아가면 좋은데, 답을 못 찾으면 같은 자리를 계속 맴돕니다. 검색하고, 안 되면 또 검색하고, 곁가지를 띄우고, 또 띄우고요. 사람은 자리에 없고 사용량만 줄어드는 상황이 여기서 생깁니다. 200이라는 숫자는 "이쯤이면 정상 작업이 아니다"라는 선인 셈입니다. 조절하거나 끄는 것도 됩니다.

기다림을 다루는 항목이 둘 더 붙었습니다. 외부 도구를 부른 지 2분이 지나면 자동으로 뒤로 넘겨 세션이 멈추지 않게 하고, 오래 걸리는 작업 줄에는 경과 시간이 흐릅니다. 후자는 사소해 보이지만 "멈춘 건지 도는 건지"를 구분하게 해주는 장치입니다. 앞의 화면 이야기와 결이 같습니다 — 지금 무슨 일이 벌어지는지 알 수 있게 하는 쪽입니다.

🔁 반대로, 예쁜 화면이라야 되는 것도 있습니다

꾸밈을 걷어내는 쪽을 봤으니 반대편도 한 줄 적어 둡니다. 변경 사항을 옆에 띄우는 패널은 전체 화면 렌더링이 켜져 있어야만 열립니다. 거기에 깃 저장소일 것, 터미널이 110칸 이상일 것까지 채워야 하고요. 조건을 못 채우면 화면을 덮는 옛 방식 뷰어가 대신 뜹니다. 즉 꾸민 화면을 끄면 가벼워지는 대신 이런 기능은 함께 빠집니다. 어느 쪽이 나은지는 쓰는 방식에 따라 다르니, 잃는 것도 알고 고르시는 편이 낫습니다.

🔁 계속 바뀌는 화면에도 멈춤 장치가 있습니다

꾸며 놓은 화면이 오히려 읽기를 막던 사례를 봤으니, 쉬지 않고 갱신되는 화면 쪽도 적어 둡니다. 서버 세션에 붙어 실시간으로 따라가는 화면에서는 기록을 위로 올려 읽는 순간 따라가기가 멈춥니다. 맨 끝으로 내려오면 다시 흘러가고요. 내용이 계속 밀려 올라가 읽던 자리를 놓치는 일을 막으려는 장치입니다. 상세 표시를 접었다 폈다 하는 키도 따로 있어서 필요한 만큼만 보이게 줄일 수 있습니다. 화면이 화려한 것보다 내가 멈춰 세울 수 있는지가 결국 읽기 편함을 가릅니다.

자주 묻는 질문

Q. 낭독 프로그램을 안 쓰는데 켤 이유가 있나요?

있을 수 있습니다. 출력이 제자리에서 갱신되지 않고 줄로 쌓이니, 진행 과정을 그대로 남겨두고 나중에 훑어보기 좋습니다. 화면이 어지러워 눈이 피로하신 분에게도 맞을 수 있고요. 다만 보기 좋은 화면은 포기해야 하니, 평소에 쓸 모드는 아닙니다.

Q. 200번 상한에 걸리면 어떻게 되나요?

문서에 그 이후 동작은 적혀 있지 않습니다. 확인된 건 상한값과 조절하는 방법뿐입니다. 다만 정상적인 작업 한 번에 검색을 200번 하는 경우는 드뭅니다. 이 숫자에 닿았다면 일이 잘 안 풀리고 있다는 신호로 보고 지시를 다시 살펴보는 편이 낫습니다. 끝까지 돌리는 방식을 쓰신다면 특히 알아두실 만합니다.

Q. 화면 그리는 방식이 그렇게 중요한가요?

도구를 쓰는 조건 자체가 되기 때문입니다. 같은 기능이라도 결과를 확인할 수 없으면 못 쓰는 도구가 됩니다. AI를 일하게 만드는 환경 설계를 다룬 적이 있는데, 결과가 사람에게 어떻게 닿는지도 그 환경의 일부입니다. 이번 모드는 그 부분을 갈아 끼운 사례입니다.

🧾 솔직하게 밝혀둘 것

① 저는 낭독 프로그램을 쓰지 않습니다. 실제 사용 경험이 아니라 공식 문서를 읽고 정리한 것이라, 쓰기에 충분한지는 판단할 수 없습니다.

② "왜 예쁜 화면이 방해가 되나"의 설명은 일반적인 원리이고, 이 도구가 그 문제를 어느 정도로 겪었는지는 문서에 없습니다.

③ 200번 상한에 도달했을 때의 동작은 확인하지 못했습니다. 상한값과 조절 방법만 문서에 있습니다.

④ 한 주치(7월 13~17일) 변경점이라 지금은 더 바뀌었을 수 있습니다. 상한 기본값도 마찬가지입니다.

⑤ 옵션·환경 변수·설정 이름은 문서 표기 그대로 옮겼습니다. 쓰기 전에 원문에서 확인하시는 편이 안전합니다.

✨ 정리하면

터미널을 예쁘게 그리는 기술이 늘면서 그 화면을 소리로 듣는 쪽은 오히려 멀어졌습니다. 이번 모드는 그 예쁨을 포기하는 선택지를 따로 만들어둔 것이고, 켜는 방법을 세 단계로 나눠 잠깐 써보기 쉽게 해뒀습니다. 같은 주에 들어온 상한과 경과 시간 표시도 결국 "지금 무슨 일이 벌어지는지 알 수 있게" 하는 쪽이라, 한 방향으로 읽힙니다.

끝까지 돌리는 방식은 Ralph 루프 정리, 환경을 설계하는 관점은 하네스 엔지니어링에 있고, 최근 주간 변경점은 취약점 스캔 정리에 이어집니다. AI에 쓰는 돈 전체는 AI 지출 허브에서 순서대로 보실 수 있습니다.

※ 출처: 제조사 공식 문서의 주간 변경점 페이지(2026년 7월 13~17일 구간) 원문. 2026년 8월 25일 확인 기준이며, 옵션 이름·기본값·동작은 이후 버전에서 바뀔 수 있습니다.