요즘 터미널에서 AI 쓰시는 분들 많으시죠?
저도 처음엔 반신반의했는데, 막상 써보니까 생각보다 쓸만하더라고요. Codex, Claude, Gemini 같은 AI CLI 도구들이 코드 짜고 분석하는 데 꽤 도움이 됩니다.
그래서 이번에 제가 실제로 써본 경험을 바탕으로, 각 도구의 장단점이랑 어떻게 활용하면 좋을지 정리해봤습니다.
AI CLI 도구, 왜 쓰는 걸까?
간단하게 말하면 터미널에서 명령어 몇 줄로 AI한테 코드 짜달라고 부탁할 수 있는 거예요. IDE 켜기 귀찮을 때나, 서버 접속해서 바로 작업해야 할 때 진짜 편합니다.
특히 이런 상황에서 유용해요:
- 서버에 SSH로 붙어서 작업할 때
- 원격 개발 환경 쓸 때
- CI/CD 파이프라인에 넣어서 자동화할 때
- 그냥… IDE 켜기 귀찮을 때
대표적인 도구 세 가지
Codex CLI – 코드 생성이 강함
OpenAI에서 만든 건데, 코드 생성이랑 리팩토링에 강해요. 특히 새로운 API 만들거나 기존 코드 정리할 때 쓰면 좋습니다.
제가 주로 이럴 때 씁니다:
- Node.js로 REST API 빠르게 만들 때
- 레거시 코드 구조 개선할 때
- 함수 단위로 코드 정리할 때
Claude CLI – 긴 코드 읽는 게 장점
Claude는 한 번에 많은 코드를 읽을 수 있어요. 그래서 큰 프로젝트 분석하거나 레거시 코드 파악할 때 쓰기 좋습니다.
이런 작업에 추천:
- 오래된 프로젝트 구조 파악하기
- 파일 크기 큰 코드 리뷰
- 복잡한 비즈니스 로직 설명 받기
Gemini CLI – 구글 제품이랑 잘 맞음
구글에서 만든 거라 구글 생태계랑 연동이 잘돼요. 테스트 코드 만들거나 문서 작성할 때 괜찮습니다.
요런 용도로 씁니다:
- 테스트 코드 초안 작성
- API 문서 자동으로 만들기
- 코드 품질 체크
참고 문서
실제로 어떻게 쓰는지
보통 이런 순서로 씁니다:
- 뭐 만들지 자연어로 적기
- CLI 명령어로 AI 불러내기
- 나온 결과 확인
- 직접 코드 검토하고 고치기
- 테스트 돌려보기
현장에서 쓰는 예시
API 코드 만들기
"Express로 JWT 인증 있는 로그인 API 짜줘"이렇게 던지면 기본 뼈대는 금방 나와요.
오래된 코드 분석
"이 프로젝트 구조랑 핵심 로직 설명해줘"레거시 파악할 때 시간 많이 아껴줍니다.
코드 정리
"이 비동기 코드 에러 처리 추가하고 읽기 쉽게 바꿔줘"쓰면서 꼭 주의할 점
AI가 짠 코드 그냥 믿고 쓰면 안 됩니다. 진짜 중요한 부분이에요.
- 생성된 코드는 반드시 직접 확인하세요
- 로그인, 권한, 결제 관련 코드는 더더욱 꼼꼼히 봐야 해요
- 테스트 안 하고 실서버에 올리는 건 절대 금물
- 뭔가 문제 생기면 결국 내 책임이에요
AI는 코드를 대신 짜주는 비서일 뿐, 책임까지 져주진 않거든요.
섞어서 쓰면 더 좋아요
굳이 하나만 고집할 필요 없어요. 저는 상황에 따라 다르게 씁니다:
| 작업 | 쓰는 도구 | 이유 |
|---|---|---|
| 새 코드 작성 | Codex | 생성 속도가 빠름 |
| 코드 분석 | Claude | 긴 코드 잘 읽음 |
| 테스트/문서 | Gemini | 문서 작업에 강함 |
마무리하며
Codex, Claude, Gemini 같은 AI CLI 도구들, 이제는 선택이 아니라 필수인 것 같아요. 하지만 착각하면 안 되는 게, 이 도구들이 개발자를 대체하는 건 아니에요.
AI가 만든 코드는 항상 내가 이해하고, 검토하고, 테스트해야 합니다. 이것만 지키면서 쓰면 일 처리 속도도 빨라지고 코드 품질도 좋아져요.
처음 시작하실 분들은:
- 공식 문서부터 가볍게 읽어보세요
- 간단한 코드부터 만들어보세요
- 익숙해지면 점점 어려운 걸로 넘어가세요
결국 중요한 건 ‘직접 해보는 것’입니다. 오늘 바로 AI CLI 도구 하나를 골라 설치해 보시는 건 어떨까요? 작은 시도가 모여 커다란 실력 차이를 만든다고 믿습니다.
감사합니다.