빠른 흐름

통합 터미널 기본 흐름
1. Cmd+J 로 현재 스레드의 터미널을 연다
2. 테스트, 린트, git 상태 확인 같은 검증 명령을 실행한다
3. Codex에게 현재 터미널 출력 기준으로 다음 행동을 요청한다
4. 반복 명령이면 action 으로 승격한다

기억할 단축키
- Cmd+J: 터미널 열기/닫기
- Ctrl+L: 터미널 화면 지우기
- Cmd+K: 명령 팔레트

터미널 흐름

통합 터미널이 검증 루프를 대화 안으로 끌어들이는 이유

Codex app의 통합 터미널은 스레드별로 붙어 있는 검증 공간입니다. 프로젝트나 Worktree에 맞는 위치에서 바로 명령을 실행할 수 있어, 수정과 검증을 같은 화면에서 이어가기 좋습니다. 핵심은 Codex가 현재 터미널 출력을 읽을 수 있다는 점입니다. 실패한 빌드 로그나 실행 중인 개발 서버 상태를 기준으로 다음 수정 단계를 이어서 요청할 수 있어, 외부 터미널과 대화 창을 번갈아 보는 방식보다 맥락이 끊기지 않습니다.

실전 검증 루프
1. Cmd+J
2. npm test
3. 실패 로그가 나오면 "지금 터미널 출력 기준으로 가장 작은 수정부터 해 줘"
4. 고친 뒤 같은 터미널에서 다시 npm test

일회성 디버깅 명령과 action 승격의 경계를 구분해야 한다

한두 번만 쓰는 디버깅 명령은 터미널에서 직접 실행하고, 매번 반복하는 명령은 local environment action으로 올리는 식으로 역할을 나누면 편합니다. action은 상단 버튼으로 등록되어 명령 전체를 다시 입력하지 않아도 되고, 실행 위치도 통합 터미널과 자연스럽게 연결됩니다. 공식 문서는 git status, git pull --rebase, npm test, pnpm run lint 같은 명령을 대표적인 사용 예로 듭니다. 이처럼 자주 반복되는 검증 명령일수록 action으로 올려 두는 편이 세션 전체 효율에 도움이 됩니다.

Cmd+K와 Ctrl+L의 역할 혼동이 반복 실수를 만든다

터미널 환경에 익숙한 사람은 Cmd+K가 터미널을 지운다고 기억하는 경우가 많습니다. 하지만 Codex app에서 Cmd+K는 명령 팔레트를 여는 단축키입니다. 터미널 화면을 정리하려면 Ctrl+L을 써야 합니다. 이 두 키의 역할을 명확히 구분하지 않으면 명령 팔레트가 의도치 않게 열리거나, 터미널 출력이 지워지지 않은 상태에서 Codex가 이전 로그를 섞어 읽는 상황이 반복됩니다.

개발 서버 출력을 Codex에게 명시해야 정확한 맥락이 잡힌다

장시간 실행되는 개발 서버나 watch 프로세스는 터미널에 계속 출력을 남기기 때문에, Codex가 어느 출력을 기준으로 판단해야 하는지 불분명해질 수 있습니다. "현재 터미널 출력 기준으로 상태를 봐 달라"처럼 명시적으로 지정해 주면 Codex가 더 정확히 맥락을 잡습니다. 특히 서버 재시작 전후의 로그가 섞여 있을 때는 Ctrl+L로 출력을 정리한 뒤 다시 요청하는 편이 안정적입니다.

터미널과 action을 나누는 기준
- 한두 번만 보는 디버깅 명령: 통합 터미널
- 세션마다 반복하는 검증 명령: action
- 현재 실패 로그를 읽고 다음 수정을 정할 때: 통합 터미널 출력 기준

언제 나눠 쓸까

주의할 점

실패 예시
- watch 서버 로그가 길게 쌓인 상태에서 "이 에러 고쳐 줘"라고만 요청함
- 결과: Codex 가 오래된 로그와 최신 로그를 섞어 읽어 잘못된 원인을 잡을 수 있음
- 대응: Ctrl+L 로 화면을 정리하고, 방금 출력된 로그 기준이라고 명시한 뒤 요청한다