ACP 에이전트와 함께 Noir 사용하기

ACP(Agent Client Protocol) 제공자를 사용하면 Noir가 직접 HTTP LLM API 대신 AI 에이전트 프로세스와 통신합니다.

지원되는 ACP 제공자

• acp:codex -> npx @zed-industries/codex-acp 실행
• acp:gemini -> gemini --experimental-acp 실행
• acp:claude -> npx @zed-industries/claude-agent-acp 실행
• acp:<custom> -> <custom> 명령을 ACP 호환 에이전트로 실행

사용 방법

Codex (권장 테스트 대상)

noir scan ./myapp --ai-provider=acp:codex

Gemini

noir scan ./myapp --ai-provider=acp:gemini

Claude

noir scan ./myapp --ai-provider=acp:claude

모델 지정 (선택 사항)

acp:*에서는 --ai-model이 필수가 아닙니다.

noir scan ./myapp --ai-provider=acp:codex --ai-model=codex

로그 동작

기본적으로 Noir는 ACP 라이프사이클 이벤트를 Noir 스타일 로그로 출력하고, ACP/에이전트의 원본 stderr 로그는 숨깁니다.

원본 ACP/에이전트 로그가 필요하면:

NOIR_ACP_RAW_LOG=1 noir scan ./myapp --ai-provider=acp:codex

참고

• acp:* 제공자에서는 --ai-key가 필요하지 않습니다.
• 캐시 플래그(--cache-disable, --cache-clear)는 다른 AI 제공자와 동일하게 동작합니다.
• acp:claude-code는 acp:claude와 동일하게 동작하는 alias입니다.