문제 해결: 터미널

빈 출력, 입력 문제, AI 에이전트 오작동 등 자주 발생하는 터미널 문제를 해결합니다.

터미널이 열렸지만 입력해도 출력이 없음

증상: 키를 눌러도 터미널에 아무것도 나타나지 않거나, 터미널이 빈 화면으로 열린 채 그대로 멈춰 있습니다.

가능한 원인과 해결 방법:

셸 초기화 파일 오류. 셸 시작 파일(.zshrc, .bashrc, .bash_profile)에 구문 오류가 있거나 멈춰 버리는 명령이 있을 수 있습니다. 1DevTool에서 일반 Bash 터미널을 열고 다음을 실행하세요.

bash
cat ~/.zshrc

닫히지 않은 따옴표, 정의되지 않은 변수, 존재하지 않는 파일을 가리키는 source 명령처럼 눈에 띄는 오류를 찾아보세요. Env Manager나 텍스트 편집기에서 오류를 수정한 다음 터미널을 다시 여세요.

잘못된 터미널 유형. “Claude Code” 터미널을 선택했지만 claude CLI가 설치되어 있지 않다면, 터미널은 열려도 셸이 에이전트를 실행하지 못합니다. 먼저 Claude Code를 설치(npm install -g @anthropic-ai/claude-code)하거나, 터미널 유형을 일반 Bash 또는 Zsh 세션으로 바꾸세요.

빠른 초기화. 터미널 탭의 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 Restart Terminal을 선택하세요. 패널을 닫지 않고도 현재 셸 프로세스를 종료하고 새 셸을 시작합니다.


AI 에이전트가 입력에 반응하지 않음

증상: 에이전트 터미널에 프롬프트를 입력해도 스피너도, 응답도, 확인 표시도 없이 아무 일도 일어나지 않습니다.

가장 흔한 원인은 에이전트 인터페이스가 입력을 읽지 않는 하위 모드에 있는 경우입니다. 예를 들어 에이전트가 터미널 안에서 vim이나 nano 같은 텍스트 편집기로 파일을 열었다면, 키 입력은 에이전트가 아니라 해당 편집기로 전달됩니다.

해결 방법:

  • Ctrl+C를 한두 번 눌러 에이전트가 하고 있던 작업을 취소하고 기본 프롬프트로 되돌리세요. 그런 다음 메시지를 다시 입력하세요.
  • 터미널에 직접 입력하는 대신 Agent Input Overlay를 사용하세요. Cmd+I(Windows/Linux에서는 Ctrl+I)를 눌러 전용 입력 상자를 열면, 터미널 상태 문제를 우회하여 프롬프트를 에이전트에게 깔끔하게 전달합니다.
  • 에이전트가 완전히 멈춘 것처럼 보이면 터미널 탭을 마우스 오른쪽 버튼으로 클릭하고 Restart Terminal을 선택해 새 에이전트 세션을 시작하세요.

에이전트 응답 후 스크롤백이 잘림

증상: 에이전트가 긴 응답을 출력한 뒤 위로 스크롤하면 일정 거리까지만 올라가고, 이전 출력이 사라져 있습니다.

해결 방법:

  • 터미널 헤더(터미널 패널 오른쪽 위의 화살표 아이콘)에서 Expand scrollback 버튼을 클릭하세요. 더 많은 기록을 일시적으로 화면에 불러옵니다.
  • 영구적으로 해결하려면 스크롤백 한도를 늘리세요. Settings → Terminal → Scrollback Lines로 이동합니다. 기본값은 10,000줄이며 최대 100,000줄까지 늘릴 수 있습니다. 스크롤백 버퍼가 매우 크면 메모리를 더 많이 사용한다는 점에 유의하세요.

스크롤백에 글자가 뒤섞이거나 겹쳐 보임

증상: 창(pane) 크기를 조절하거나 터미널을 다시 연 뒤, 이전 기록에서 줄이 합쳐져 보이거나 엉뚱한 문자, 중복된 블록이 나타납니다.

해결 방법: 터미널에 표시되는 호박색 Repair view 알약 모양 버튼을 찾아보세요. 기록의 일부가 현재 창 너비와 다른 너비로 그려졌을 때 나타납니다. 이 버튼을 클릭하면 터미널 자체의 너비에 정확히 맞는 행으로 화면이 다시 구성됩니다.


터미널에 “[detached]” 메시지가 표시됨

터미널 상단에 [detached (from session main)] 같은 줄이 나타날 수 있습니다. 이는 1DevTool이 세션을 백그라운드에서 유지하기 위해 사용하는 터미널 멀티플렉서 tmux가 보내는 메시지입니다.

화면이 실행 중인 세션에서 일시적으로 분리되었다가 다시 연결되었다는 의미입니다. 완전히 정상적인 동작이며, 프로젝트를 전환하거나, 터미널을 숨겼다가 다시 열거나, 최소화된 앱을 복원할 때 주로 발생합니다. 세션과 실행 중인 모든 프로세스에는 영향이 없습니다.


숨긴 터미널이 이어서 실행되지 않고 새 세션으로 시작됨

증상: 다른 곳을 클릭하거나 패널을 닫아 터미널을 숨겼다가 다시 열면 터미널이 처음부터 시작되어, 이전 명령과 실행 중이던 프로세스가 사라집니다.

원인: 1DevTool은 tmux를 사용해 터미널 세션을 백그라운드에서 유지합니다. tmux가 설치되어 있지 않거나 셸의 PATH에 없으면 세션을 보존할 수 없어 매번 처음부터 다시 시작됩니다.

해결 방법: tmux를 설치한 다음 1DevTool을 다시 시작하세요.

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo dnf install tmux

설치한 후 1DevTool을 완전히 종료했다가 다시 실행하세요. 이제 새 터미널 세션은 숨겨도 유지됩니다.


터미널로 인한 높은 CPU 사용량

기기가 뜨거워지거나 팬이 시끄럽게 돌아간다면, 터미널 프로세스가 CPU를 과도하게 사용하고 있을 수 있습니다.

원인 찾기: 각 터미널 탭에 마우스를 올려 보세요. 활성 탭에는 회전하는 표시가 나타납니다. 터미널을 열고 top이나 htop을 실행해 어떤 프로세스가 원인인지 확인할 수도 있습니다.

중지하기:

  • 터미널에서 Ctrl+C를 눌러 실행 중인 프로세스를 중단하세요.
  • 또는 터미널 탭을 마우스 오른쪽 버튼으로 클릭하고 Kill Process를 선택해 내부에서 실행 중인 프로세스를 강제 종료하세요.

프로세스가 폭주한 개발 서버나 빌드 도구라면 안전하게 종료한 뒤 평소 사용하는 시작 명령으로 다시 실행해도 됩니다.