워크플로에서 로컬 claude CLI 를 실행하는 n8n 노드입니다. 실행 코드는 claude-cli 를 씁니다.
claudeCLI 를 설치하고 한 번 실행해 로그인합니다.- Background 모드를 쓸 폴더는 그 폴더에서
claude를 한 번 실행해 신뢰합니다. - 루트 README 대로 노드를 배포합니다.
| 모드 | 동작 | 출력 |
|---|---|---|
Print (-p) |
끝날 때까지 기다립니다 | result, sessionId, deniedTools, structuredOutput |
Background (--bg) |
세션을 띄우고 바로 돌아옵니다. 신뢰된 폴더에서만 실행됩니다 | backgroundId, sessionId |
| 설정 | 기본값 | 설명 |
|---|---|---|
| Tools | Read,Grep,Glob |
쉼표로 구분합니다. * 는 전체 내장 도구입니다 |
| Permission Mode | dontAsk |
쓰기 도구는 거부되고 deniedTools 로 보고됩니다 |
| Resume Session ID | 이어 갈 세션의 UUID 입니다. 비우면 새 세션을 시작합니다 | |
| Session ID | Print 전용입니다. 새 세션에 줄 UUID 입니다. 비우면 claude 가 정합니다 | |
| Max Budget (USD) | 1 |
Print 전용입니다. 0 이면 상한이 없습니다 |
| Timeout (Seconds) | 300 |
|
| JSON Schema | Print 전용입니다. 결과가 structuredOutput 에 담깁니다 |
|
| Remote Control | 꺼짐 | Background 전용입니다. 켜야 Claude Desktop 사이드바에 표시됩니다 |
| Inherit User Config | 꺼짐 | 내 MCP 서버, 스킬, 훅, 설정을 씁니다 |
Executable 에는 n8n 프로세스의 PATH 에 claude 가 없을 때 절대 경로를 넣습니다.
Print 모드는 프로세스가 남지 않습니다. 대화 기록은 남아서 Resume Session ID 로 같은 세션을 이어 갑니다.
- 세션 ID 를 먼저 정하기: 실행 전에 알림을 보내거나 대화와 세션을 연결하려면 Crypto 노드(Generate, UUID)로 만든 값을 Session ID 에 넣습니다.
- 같은 세션의 동시 실행: 같은 세션을 가리키는 실행이 겹치면 앞 실행이 끝난 뒤에 시작합니다. 그동안 뒤 실행의 n8n 실행은 기다립니다.
- 세션 목록: Print 모드 세션은
claude agents목록에 나오지 않습니다. n8n-claude-router 가 이어 갈 세션으로 찾게 하려면 Remember 의 Register Print Session 을 켭니다.