Skip to content

Latest commit

 

History

History

n8n-claude-cli

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

n8n-claude-cli

워크플로에서 로컬 claude CLI 를 실행하는 n8n 노드입니다. 실행 코드는 claude-cli 를 씁니다.

준비

  1. claude CLI 를 설치하고 한 번 실행해 로그인합니다.
  2. Background 모드를 쓸 폴더는 그 폴더에서 claude 를 한 번 실행해 신뢰합니다.
  3. 루트 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 모드로 세션 이어 가기

Print 모드는 프로세스가 남지 않습니다. 대화 기록은 남아서 Resume Session ID 로 같은 세션을 이어 갑니다.

  • 세션 ID 를 먼저 정하기: 실행 전에 알림을 보내거나 대화와 세션을 연결하려면 Crypto 노드(Generate, UUID)로 만든 값을 Session ID 에 넣습니다.
  • 같은 세션의 동시 실행: 같은 세션을 가리키는 실행이 겹치면 앞 실행이 끝난 뒤에 시작합니다. 그동안 뒤 실행의 n8n 실행은 기다립니다.
  • 세션 목록: Print 모드 세션은 claude agents 목록에 나오지 않습니다. n8n-claude-router 가 이어 갈 세션으로 찾게 하려면 Remember 의 Register Print Session 을 켭니다.