문제 해결: 터미널

터미널이 열리지만 입력 시 출력 없음

증상: 키를 누르지만 터미널에 아무것도 표시되지 않거나 터미널이 빈 화면으로 열리고 그대로 유지됩니다.

가능한 원인 및 해결:

셸 초기화 파일 오류. 셸 시작 파일(.zshrc, .bashrc 또는 .bash_profile)에 구문 오류나 중단되는 명령이 있을 수 있습니다. 1DevTool에서 일반 Bash 터미널을 열고 실행합니다:

cat ~/.zshrc

명백한 오류를 찾습니다 — 닫히지 않은 따옴표, 정의되지 않은 변수, 존재하지 않는 파일을 가리키는 source 명령. Env Manager 또는 텍스트 에디터에서 오류를 수정한 후 터미널을 다시 엽니다.

잘못된 터미널 유형. "Claude Code" 터미널을 선택했지만 claude CLI가 설치되어 있지 않으면 터미널이 열리지만 셸이 Agent를 시작하지 못합니다. 먼저 Claude Code를 설치합니다 (npm install -g @anthropic-ai/claude-code) 또는 터미널 유형을 일반 Bash 또는 Zsh 세션으로 전환합니다.

빠른 재설정. 터미널 탭 내에서 우클릭하고 Restart Terminal을 선택합니다. 현재 셸 프로세스를 종료하고 패널을 닫지 않고 새 셸을 시작합니다.

AI Agent가 입력에 응답하지 않음

증상: Agent 터미널에 프롬프트를 입력하지만 아무 일도 일어나지 않습니다 — 스피너 없음, 응답 없음, 확인 없음.

가장 일반적인 원인은 Agent의 인터페이스가 입력을 읽지 않는 하위 모드에 있다는 것입니다. 예를 들어 Agent가 터미널 내에서 vim이나 nano 같은 텍스트 에디터에서 파일을 열면 키 입력이 Agent 대신 해당 에디터로 전달됩니다.

해결:

• Ctrl+C를 한두 번 눌러 Agent가 하고 있는 것을 취소하고 메인 프롬프트로 돌아갑니다. 그런 다음 메시지를 다시 입력합니다.
• 터미널에 직접 입력하는 대신 Agent Input Overlay를 사용합니다. Cmd+I (또는 Windows/Linux에서 Ctrl+I)를 눌러 전용 입력 상자를 열어 터미널 상태 문제를 우회하여 프롬프트를 깔끔하게 Agent에게 보냅니다.
• Agent가 완전히 멈춘 것처럼 보이면 터미널 탭을 우클릭하고 Restart Terminal을 선택하여 새 Agent 세션을 시작합니다.

Agent 응답 후 스크롤백이 잘림

증상: Agent가 긴 응답을 생성한 후 위로 스크롤하지만 특정 거리까지만 돌아갈 수 있습니다. 이전 출력이 사라졌습니다.

해결:

• 터미널 헤더에서 Expand scrollback 버튼을 클릭합니다 (터미널 패널 오른쪽 상단의 화살표 아이콘). 이렇게 하면 일시적으로 더 많은 기록이 뷰에 로드됩니다.
• 영구적인 해결을 위해 스크롤백 제한을 증가시킵니다: Settings → Terminal → Scrollback Lines로 이동합니다. 기본값은 10,000행입니다. 100,000까지 높일 수 있습니다. 매우 큰 스크롤백 버퍼는 더 많은 메모리를 사용함을 참고하세요.

터미널에 "[detached]" 메시지 표시

터미널 상단에 [detached (from session main)] 같은 행이 표시될 수 있습니다. 이것은 1DevTool이 백그라운드에서 세션을 유지하는 데 사용하는 터미널 멀티플렉서인 tmux의 메시지입니다.

디스플레이가 실행 중인 세션에서 일시적으로 연결이 끊어졌다가 다시 연결되었음을 의미합니다. 완전히 정상입니다 — 일반적으로 프로젝트를 전환하거나 터미널을 숨겼다가 다시 열거나 앱이 최소화 상태에서 복원될 때 발생합니다. 세션과 모든 실행 중인 프로세스는 영향을 받지 않습니다.

숨긴 터미널이 재개 대신 새 세션 시작

증상: 터미널을 클릭 away하거나 패널을 닫아 숨긴 후 다시 열면 터미널이 새로 시작됩니다 — 이전 명령과 실행 중인 프로세스가 사라졌습니다.

원인: 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를 선택하여 내부에서 실행 중인 것을 강제 종료합니다.

프로세스가 폭주한 개발 서버 또는 빌드 도구라면 안전하게 종료하고 일반 시작 명령으로 다시 시작할 수 있습니다.