Quick Flow
ChatGPT desktop app의 terminal은 현재 chat이 연 project 또는 worktree에 묶입니다. terminal icon 또는 Ctrl + `으로 열고, Codex가 현재 출력을 읽을 수 있는 상태에서 test·Git 상태·개발 서버를 확인합니다.
# 수정 전후의 최소 검증 묶음
git status --short
npm test
npm run lint| 할 일 | 조작 | 알아둘 경계 |
|---|---|---|
| terminal 열기 | terminal icon 또는 Ctrl + ` | Cmd/Ctrl + J는 bottom panel 전체 토글입니다. |
| 현재 출력 지우기 | Ctrl + L | 화면만 정리합니다. 실행 기록이나 실패 원인은 별도로 남깁니다. |
| 반복 명령 실행 | local environment action | action은 통합 terminal에서 실행됩니다. |
| 긴 개발 서버 확인 | terminal에서 시작 후 URL·상태를 명시 | 과거 로그와 최신 로그를 구분해야 합니다. |
chat과 terminal의 연결
각 chat의 terminal은 그 chat이 선택한 local project 또는 worktree에서 실행됩니다. 같은 repository를 다른 worktree로 열었다면 package install, Git status, dev server port가 서로 다른 작업 공간을 가리킬 수 있습니다. 명령을 실행하기 전에 pwd와 git status --short로 현재 위치와 기존 변경을 확인하면, 다른 task의 working tree에서 test나 commit을 실행하는 실수를 줄일 수 있습니다.
Codex는 현재 terminal output을 읽어 failed build, test failure, running development server를 작업 근거로 삼을 수 있습니다. 하지만 watch log가 길게 쌓인 상태에서는 어느 실행이 최신인지 자동으로 추측시키지 않습니다. 실패를 전달할 때 실행 명령, 마지막 오류, 서버를 재시작했는지를 함께 적습니다.
"통합 terminal에서 npm run build를 다시 실행했습니다.
마지막 오류는 src/auth/token.ts:42의 타입 오류입니다.
이전 dev server 로그는 무시하고 이 오류만 최소 수정으로 고쳐 주세요."반복 명령과 action
매번 같은 test, lint, Git 상태 확인을 실행한다면 local environment의 action으로 등록할 수 있습니다. action은 desktop app의 shortcut으로 나타나고 통합 terminal에서 실행되므로, 잘 알려진 검증 명령을 다시 입력할 필요가 없습니다. 반대로 일회성 migration, 임시 진단, destructive command는 action으로 넓게 고정하지 말고 실행 전 범위와 approval을 직접 확인합니다.
Cmd + K는 command palette를 열며 terminal clear가 아닙니다. terminal 출력은 Ctrl + L로 지웁니다. clear 뒤에는 Codex도 직전 출력 문맥을 화면에서 볼 수 없으므로, 필요한 stack trace나 test 결과를 먼저 복사하거나 요약합니다.
개발 서버를 확인할 때
서버를 시작한 뒤에는 route, port, 기대 상태를 함께 지정합니다. 예를 들어 http://localhost:3000/settings의 narrow viewport에서 overflow를 확인할 것인지, API health endpoint의 status code만 볼 것인지가 달라야 다음 검증이 흔들리지 않습니다. browser로 렌더링을 확인할 때는 terminal output만으로 UI가 정상이라고 결론 내리지 말고 페이지와 diff를 함께 봅니다.
통합 terminal은 현재 chat의 worktree를 공유합니다. 다른 chat이나 사용자가 이미 수정한 파일을 그 chat의 산출물로 오해하지 않도록, 명령 전 Git status와 worktree 경로를 확인하고 commit·push 같은 쓰기 동작은 사용자의 명시적 요청이 있을 때만 수행하십시오.
참고 링크
2 sources