CLI 워크플로우

기능을 익혔다면 실제 작업에 적용할 차례입니다. 잘 쓰는 핵심은 작업을 작게 쪼개고 단계마다 검증하는 데 있습니다.

학습 목표

• 기능 추가·버그 수정·리팩터링의 진행 흐름을 안다.
• 대화형과 비대화형(스크립트) 실행의 차이를 이해한다.
• 큰 작업을 안전하게 나누는 법을 익힌다.

기능 추가

새 기능은 계획을 먼저 받는 것이 좋습니다.

> 댓글에 대댓글(답글) 기능을 추가하려고 해. 먼저 구현 계획을 세워줘.

계획이 타당하면 단계별로 실행을 지시하고, 단계가 끝날 때마다 확인합니다.

버그 수정

버그는 재현 → 원인 → 수정 → 검증 순서로 맡깁니다.

> 파일 업로드 시 한글 파일명이 깨져. 먼저 원인을 찾아줘.

원인을 확인한 뒤 수정과 회귀 테스트를 함께 요청합니다.

리팩터링

동작을 바꾸지 않는다는 점을 명확히 합니다.

> 동작은 그대로 두고, 이 클래스의 책임을 두 개로 분리해줘. 끝나면 테스트를 돌려줘.

비대화형 실행

CLI는 대화형 외에, 명령 한 줄로 작업을 실행하는 모드도 제공합니다. CI 파이프라인이나 스크립트에서 자동화할 때 유용합니다.

codex exec "변경된 파일에 대한 변경 로그를 CHANGELOG.md에 추가해줘"

이렇게 하면 사람의 개입 없이 작업을 한 번에 수행합니다. 자동화 환경에서는 승인 정책과 샌드박스를 더 신중히 설정해야 합니다.

비대화형 서브커맨드 이름은 버전에 따라 다를 수 있으니 codex --help로 확인하세요.

작게 쪼개기

큰 작업 → 작은 단계 → 단계 실행 → 검증 → 커밋 → 다음 단계

단위마다 커밋해 두면 문제가 생겨도 쉽게 되돌릴 수 있습니다.

요약

CLI 작업의 핵심은 계획 우선, 작은 단위, 단계별 검증·커밋입니다. 대화형으로 진행하거나 codex exec로 자동화할 수 있으며, 자동화 시에는 승인·샌드박스 설정을 더 신중히 다뤄야 합니다.