A-2. 명령어 치트시트 — 만들기 + 관리하기 전체
강의 전체에서 사용한 명령어를 한 곳에 모은 레퍼런스입니다. 학습용으로 처음부터 따라가도 좋고, 실무에서 "그 명령어가 뭐였지?" 하는 순간에 찾아보는 용도로도 활용할 수 있습니다.
1. 환경 세팅 명령어
Claude Code 설치
npm install -g @anthropic-ai/claude-code설치 후 터미널에서 claude를 입력하면 Claude Code가 실행됩니다.
n8n 서버 실행 (Docker)
docker run -d --name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
n8nio/n8nhttp://localhost:5678에서 n8n 웹 UI에 접속할 수 있습니다.
MCP 서버 연결
Claude Code 설정 파일(.claude/settings.json)에 n8n MCP 서버 정보를 등록합니다. 서버 URL과 API 키를 넣으면 Claude Code가 n8n을 직접 조작할 수 있습니다.
2. 워크플로우 만들기 (파트 1)
Chapter 3에서 다룬 워크플로우 생성 관련 명령입니다.
워크플로우 생성 요청
"매일 아침 날씨, 뉴스, 환율을 요약해서 슬랙에 보내는 워크플로우 만들어줘"스킬의 workflow-builder 모듈이 동작합니다. 요구사항 확인 → 노드 설계 → JSON 생성 → 업로드 → 검증 → 리포트 6단계가 자동 실행됩니다.
워크플로우 검증 요청
"방금 만든 워크플로우 검증해줘"n8n의 validate 도구를 호출해 노드 연결과 필수 파라미터 누락 여부를 확인합니다.
워크플로우 테스트 실행
"테스트 실행해줘"워크플로우를 한 번 실행하고 각 노드의 성공/실패 여부를 리포트로 보여줍니다. 실패한 노드가 있으면 원인 분석과 수정 제안까지 포함됩니다.
3. 워크플로우 관리 (파트 2) — 정리 & 표준화
Chapter 4에서 다룬 표준화 관련 명령입니다.
| 명령어 | 동작 |
|---|---|
"워크플로우 이름을 우리 컨벤션에 맞게 바꿔줘" | 스킬에 정의된 네이밍 규칙([팀명] 기능설명 (트리거타입))을 기준으로 전체 이름 일괄 변경 |
"에러 트리거 등록 안 된 워크플로우에 전부 등록해줘" | Error Trigger 노드가 없는 워크플로우를 찾아 자동 추가 |
"비활성 워크플로우 찾아줘" | 꺼져 있는 워크플로우 목록을 조회하고 최근 실행 기록 기반으로 정리 대상 추천 |
"워크플로우 전부 우리 컨벤션에 맞게 정리해줘" | 네이밍·에러 트리거·비활성 감지를 한 번에 묶어 실행 |
4. 워크플로우 관리 (파트 2) — 모니터링 & 사용자
Chapter 5에서 다룬 운영 모니터링 관련 명령입니다.
| 명령어 | 동작 |
|---|---|
"최근 에러 리포트 만들어줘" | 실패한 워크플로우를 추출하고 원인 분석과 해결 제안을 포함한 리포트 생성 |
"지난 일주일간 새로 만든 워크플로우 알려줘" | 최근 생성된 워크플로우 목록을 누가 언제 만들었는지 함께 표시 |
"퇴사자 워크플로우 정리해줘" | 특정 사용자의 워크플로우를 조회하고 인계 대상자에게 소유권 이전 또는 비활성 처리 |
"워크플로우 전부 백업해줘" | 모든 워크플로우를 JSON 파일로 내려받아 날짜별 폴더에 저장 |
5. 종합 운영 리포트
모든 관리 작업을 하나로 합친 명령입니다.
"이번 주 운영 리포트 만들어줘"이 한 줄로 다음 항목이 모두 포함된 리포트가 생성됩니다.
- 전체 워크플로우 현황 (활성/비활성 수)
- 신규 생성된 워크플로우 목록
- 에러 발생 현황과 원인 분석
- 비활성 워크플로우 정리 대상
- 사용자별 워크플로우 보유 현황
리포트 하나로 n8n 서버의 건강 상태를 한 번에 파악할 수 있습니다.
6. 명령어 요약 테이블
| 카테고리 | 명령어 | Chapter |
|---|---|---|
| 환경 세팅 | npm install -g @anthropic-ai/claude-code | Ch.1 |
| 환경 세팅 | docker run ... n8nio/n8n | Ch.1 |
| 환경 세팅 | MCP 서버 연결 (settings.json) | Ch.1 |
| 만들기 | "워크플로우 만들어줘" | Ch.3 |
| 만들기 | "검증해줘" | Ch.3 |
| 만들기 | "테스트 실행해줘" | Ch.3 |
| 표준화 | "이름 컨벤션에 맞게 바꿔줘" | Ch.4 |
| 표준화 | "에러 트리거 등록해줘" | Ch.4 |
| 표준화 | "비활성 워크플로우 찾아줘" | Ch.4 |
| 모니터링 | "에러 리포트 만들어줘" | Ch.5 |
| 모니터링 | "신규 워크플로우 알려줘" | Ch.5 |
| 사용자 | "퇴사자 워크플로우 정리해줘" | Ch.5 |
| 백업 | "전부 백업해줘" | Ch.6 |
| 종합 | "운영 리포트 만들어줘" | Ch.5 |
7. 마무리
이 치트시트는 강의 전체에서 배운 핵심 명령어를 한 곳에 모은 것입니다. 실무에서 "그 명령어가 뭐였지?" 하는 순간이 오면 이 페이지로 돌아오십시오.
★ 핵심. 명령어를 외울 필요는 없습니다. Claude Code는 자연어를 이해하므로 의도만 전달하면 동작합니다. "이름 좀 정리해줘"와 "네이밍 컨벤션 적용해줘"는 같은 결과로 이어집니다.
여러분의 n8n 운영이 더 편해지길 바랍니다.