호환성 및 주의사항
ADHDev는 광범위한 내장 프로바이더 인벤토리를 제공하지만, 호환성은 여전히 보수적으로 읽어야 합니다. 이 페이지는 특정 워크플로우에 의존하기 전에 기대치를 설정하는 가장 빠른 방법입니다.
인벤토리 우선, 검증 두 번째
다음 규칙을 따르세요:
- 내장은 프로바이더가 출시된 인벤토리에 존재한다는 의미입니다.
- 검증은 프로바이더가 수동으로 테스트되고 프로모션되었다는 의미입니다.
- 프로바이더가 프로모션될 때까지 런처, 문서, 또는 기능 페이지에 나타나더라도 미검증으로 취급하세요.
재검증 진행 중
검증 상태는 현재 전면 재검증 중입니다(오너 결정, 2026-08-03). 새로운 검증 결과가 나올 때까지 모든 프로바이더는 Unverified입니다 — 시작점을 고르기 전에 지원 프로바이더에서 현재 상태를 확인하세요.
실용적인 시작점
프로바이더 선택은 현재 Partial 프로모션이 아니라 워크플로우에 맞는 카테고리를 기준으로 해야 합니다 — 지금은 활성화된 프로모션이 없습니다. 카테고리별 전체 인벤토리는 지원 프로바이더를 참고하세요.
IDE 워크플로우
네이티브 IDE 제어, Remote View, 세션 전환은 ide 카테고리를 통해 이루어집니다. 전체 목록은 지원 IDE를 참고하세요.
익스텐션 워크플로우
IDE 익스텐션(Cline, Roo Code, Codex, Claude Code for VS Code)은 extension 카테고리를 통해 이루어집니다. 프로바이더가 프로모션되기 전까지는 모두 탐색적인 것으로 취급하세요.
CLI 워크플로우
CLI 에이전트(Claude Code, Codex CLI 등)는 호스팅 PTY/세션-호스트 스택을 통해 실행되며, 보통 원격 모니터링 및 복구 흐름을 검증하는 가장 쉬운 곳입니다.
알려진 주의사항
IDE 지원은 Electron 우선
ADHDev는 IDE 제어를 위해 Chrome DevTools Protocol에 의존합니다. 즉, Electron 기반 IDE가 현재 주요 대상입니다.
- 오늘 Electron 우선 대상 세트: Cursor, Windsurf, Kiro, PearAI, Antigravity, Trae
- 감지/실행 커버리지: VS Code, VSCodium
- 현재 적합하지 않음: Zed, IntelliJ, 유사한 네이티브 데스크탑 앱 같은 비 Electron IDE
VS Code 계열은 Cursor/Windsurf와 다릅니다
VS Code와 VSCodium은 감지하고 실행할 수 있지만, 네이티브 통합 AI IDE와 동일하지 않습니다. Cline, Roo Code, Codex, 또는 Claude Code 같은 익스텐션 흐름을 추가하면 훨씬 더 관련성이 높아집니다.
Trae는 실제 주의사항이 있습니다
Trae는 채팅과 제어에 작동하지만, 모델 및 모드 컨트롤은 여전히 일반 UI 상호작용에 의존하며 앱 버전과 레이아웃에 따라 실패할 수 있습니다.
실제로:
- 채팅 읽기 작동
- 메시지 전송 작동
- Remote View 작동
- 모델 전환과 모드 전환은 부분적으로 취급해야 함
ACP 시작 플래그는 업스트림을 따릅니다
각 ACP 어댑터는 대상 도구가 요구하는 플래그로 시작하며, 이 플래그는 에이전트가 실험적에서 안정 단계로 넘어감에 따라 업스트림을 따라 바뀝니다.
- Qwen Code (ACP)는
--acp로 시작합니다
업스트림 도구가 플래그를 이름 변경하거나 제거하면, 어댑터의 시작 인자를 그에 맞게 업데이트하세요.
인증은 여전히 도구별입니다
ADHDev는 각 도구의 자체 로그인 흐름을 대체하지 않습니다.
- CLI 및 ACP 에이전트는 여전히 자체 API 키나 로그인 상태가 필요합니다
- API 키 누락은 아직 기본 도구를 인증하지 않은 경우 실행 실패처럼 보일 수 있습니다
- 이는 Claude, Codex, 많은 ACP 에이전트에 특히 중요합니다
푸시 알림은 플랫폼에 따라 다릅니다
푸시 알림은 대시보드가 PWA로 설치되어 있을 때 가장 잘 작동합니다.
- iOS는 웹 푸시를 위한 PWA 설치 경로가 필요합니다
- 알림 액션 버튼은 모든 플랫폼에서 일관되게 표시되지 않습니다
- 액션 버튼이 제공되지 않더라도 알림 자체는 도달할 수 있습니다
Windows는 현재 Node.js 24+를 차단합니다
ADHDev는 현재 일반 npm/전역 CLI 설치 및 시작에서 Windows + Node.js 24+ 를 지원하지 않는 것으로 처리합니다.
- PowerShell 원라인 설치 프로그램은 이 조합을 감지하면 이제 휴대용 Node.js 22 런타임을 부트스트랩합니다
- Windows에서 직접
npm install -g adhdev를 사용할 계획이라면 Node.js 22.x를 사용하세요 - 이는 Windows PTY/세션-호스트 경로가 최신 Node 릴리스에서 안정화될 때까지의 임시 보호 조치입니다
Linux는 아직 인벤토리 우선입니다
일부 문서 및 인벤토리 표에 Linux가 언급되는 것은 출시된 프로바이더/감지기 인벤토리가 Linux 지향 프로세스 이름, 포트, Unix 스타일 명령 경로를 포함하기 때문입니다.
이것을 아직 공개 지원 약속으로 읽어서는 안 됩니다.
- 현재 공개 설치 테스트 경로는 macOS와 Windows입니다
- Linux는 아직 지원되는 경로로 제시하기에 충분히 검증되지 않았습니다
- 오늘 Linux에서 실험한다면 미검증으로 취급하고 수동 문제 해결을 예상하세요
클라우드 vs 스탠드얼론 기대치
클라우드
다음이 필요할 때 클라우드를 사용하세요:
- 로컬 네트워크 외부에서의 접근
- 푸시 알림
- 멀티 머신 관리
- API 키와 웹훅
스탠드얼론
다음이 필요할 때 스탠드얼론을 사용하세요:
- 로컬 전용 설정
- 클라우드 의존성 없음
- LAN 기반 모니터링 및 제어
스탠드얼론은 OSS 사용자와 로컬 팀에 훌륭하지만, 푸시 알림과 인터넷 facing 원격 접근 같은 클라우드 전용 기능은 해당 경로의 일부가 아닙니다.
오늘 보통 가장 잘 작동하는 것
제품의 가장 대표적인 첫인상을 원한다면, 특정 프로바이더의 프로모션 상태에 의존하지 않는 일반적인 접근 방식은 다음과 같습니다:
- 네이티브 제어, 모바일 승인, Remote View를 원한다면 데스크탑 IDE 워크플로우 선택
- 특정 익스텐션 통합을 원하는 경우에만 익스텐션 워크플로우 선택
- 가장 단순하고 직접적인 워크플로우를 원한다면 대시보드 터미널을 통한 CLI 에이전트 선택
- 기본 사항이 안정적으로 느껴질 때까지 먼저 한 대의 머신에 하나의 프로바이더, 그 다음 멀티 머신
현재 상태 확인 위치
현재 프로모션 목록과 카테고리별 상태는 지원 프로바이더를 사용하세요. 해당 페이지는 단순히 인벤토리에 있는 것과 명시적인 검증이 있는 것에 대한 공개 레퍼런스입니다.