Grok CLI 사용법 & 프롬프트 팁

xAI Grok Build TUI 완전 가이드 — Claude Code 사용자도 바로 적응할 수 있게 구성

⭐ 가장 자주 쓰는 것 (Grok에서 특히 강력한 기능)

Claude Code를 쓰던 사람이라면 이 기능들부터 익히세요. Grok의 진짜 힘은 여기서 나옵니다.

1. Grok CLI 개요

Grok CLI (Grok Build)는 xAI에서 만든 터미널 기반 에이전트 코딩 도구입니다. 단순한 채팅을 넘어, 도구 호출(Tools), Plan Mode, Subagent 병렬 실행, Skills 등 강력한 구조를 가지고 있습니다.

2. 슬래시 명령어 (/)

프롬프트 맨 앞에 /를 입력하면 자동완성 목록이 나옵니다. 자주 쓰이는 것들 위주로 정리했습니다.

2-1. 세션 관리

# 큰 작업 시작 전 항상 새 세션
/new

# 컨텍스트가 너무 길어지면
/compact keep only the final API design decisions

# 세션 상태 확인
/context

2-2. Plan Mode 관련

2-3. 워크플로우 & 스케줄링

# 5분마다 서버 로그 확인 + 이상 있으면 보고
/loop 5m "server.log 마지막 30줄을 보고 에러가 있으면 알려줘"

# 매시간 테스트 실행
/loop 1h "npm test -- --watchAll=false 실행해서 실패 있으면 요약해줘"

2-4. 설정 및 도구 관리

3. 핵심 도구 (Tools)

Grok은 프롬프트만으로 대답하는 것이 아니라, 실제로 도구를 호출해서 파일을 읽고, 수정하고, 명령을 실행합니다. 주요 도구들을 알아두면 프롬프트를 훨씬 정확하게 쓸 수 있습니다.

먼저 @app.py 와 @Tech/program/grok/grok-guide.html 을 read_file로 확인한 뒤,
검색이 필요한 부분은 grep으로 찾고,
수정은 반드시 search_replace를 사용해서 정확히 고쳐줘.
작업 단계는 todo_write로 관리하면서 진행해.

4. 서브에이전트 (Subagents)

Grok의 가장 강력한 기능 중 하나입니다. spawn_subagent 도구를 사용하면 메인 에이전트가 여러 개의 독립적인 자식 에이전트를 동시에 띄울 수 있습니다.

다음 작업을 처리해줘:

1. 메인: 전체 계획을 세우고 todo_write로 단계 정의
2. Subagent 1 (implementer persona): 실제 기능 구현
3. Subagent 2 (reviewer persona): 구현된 코드 리뷰 및 개선 제안

마지막에 두 결과를 종합해서 최종 수정까지 해줘.

5. 스킬 (Skills)

Skills는 반복되는 작업 패턴을 SKILL.md 파일로 만들어 영구적으로 재사용할 수 있게 해주는 기능입니다.

현재 이 워크스페이스에는 여러 스킬이 로드되어 있습니다 (xlsx, pptx, implement, review, design, check-work 등).

# pptx 스킬이 있으면 자연스럽게 요청
"이 프로젝트의 아키텍처를 pptx 스킬로 10장짜리 발표 자료로 만들어줘"

# implement 스킬 사용
"새로운 반도체 공부 노트 페이지를 implement 스킬 스타일로 깔끔하게 추가해줘"

자신만의 스킬을 만들고 싶다면 ~/.grok/skills/<name>/SKILL.md 또는 프로젝트 내 .grok/skills/ 에 작성하면 됩니다.

6. 키보드 단축키

7. Plan Mode 상세 가이드

Plan Mode는 Grok이 모호하거나 영향 범위가 큰 작업을 만났을 때 자동으로 제안하거나, 사용자가 의도적으로 진입시키는 읽기 전용 모드입니다.

사용자가 직접 Plan Mode를 유도하려면 다음과 같이 말하면 됩니다:

이 작업은 아키텍처 결정이 필요한 큰 작업이야. enter_plan_mode 도구를 사용해서 먼저 계획을 세워줘.

8. Claude Code 사용자 를 위한 가이드

Grok으로 Claude Code가 하던 작업을 어떻게 하면 비슷하거나 더 잘할 수 있는지 정리했습니다.

비슷한 개념 매핑

Grok이 더 강한 부분

• 병렬 처리: 여러 Subagent를 동시에 돌리기 매우 편함
• 작업 추적: todo_write로 진행 상황을 명확하게 관리
• 정밀한 수정: search_replace는 문자열 기반으로 매우 정확
• Plan Mode의 강제성: 계획 단계에서 실제 수정을 원천 차단
• 스케줄링: /loop + 백그라운드 작업이 공식 지원

9. Grok 프롬프트 작성 팁

1. 도구를 의식해서 말하기

Grok은 도구를 통해 작업합니다. "파일 읽고 수정해" 대신 구체적으로 말하면 더 정확합니다.

좋은 예:
먼저 @index.html 의 Program 섹션을 read_file로 확인하고,
새로운 Grok 가이드를 추가하기 위해 search_replace를 사용해서 메뉴 항목을 추가해줘.

나쁜 예:
Grok 가이드 메뉴 좀 추가해줘.

2. 큰 작업은 무조건 Plan + Todo부터

"이 기능 추가는 아키텍처 영향이 클 것 같아. 
enter_plan_mode로 먼저 계획을 세우고, todo_write로 단계도 정의해줘."

3. 병렬화 적극 활용

조사, 구현, 테스트, 문서화를 동시에 하고 싶을 때 Subagent를 명시적으로 요청하세요.

4. 정확한 위치 지정

search_replace는 정확한 old_string을 필요로 합니다. "대략 이 부분 수정해"보다 "이 함수의 이 라인 근처"를 구체적으로 알려주는 게 좋습니다.

10. 체크리스트 & 실전 패턴

새로운 공부 노트 페이지 만들 때 (이 프로젝트 예시)

1. 먼저 Plan Mode 진입 제안
2. todo_write로 "디렉토리 생성 → HTML 작성 → index.html 메뉴 연결 → 스타일 확인" 단계 정의
3. 기존 claude-code-guide.html 또는 다른 페이지를 read_file로 스타일 참고
4. search_replace 또는 write로 새 파일 생성
5. index.html의 해당 섹션에 메뉴 항목 추가
6. 최종적으로 브라우저에서 확인 (서버 실행 중이라면)