본문으로 건너뛰기

AI 에이전트를 위한 CLI · Windows · Linux · macOS

명령 10개를
단 한 번에.

AI 에이전트는 Git, 매니페스트, DNS, TLS, HTTP, 디스크 스캔, 중복 파일 찾기를 위해 셸 명령을 즉흥적으로 조합하며 턴을 낭비합니다. 게다가 OS마다 문법이 다릅니다. QZX는 그 작업을 하나의 크로스 플랫폼 명령으로 처리하고 바로 실행할 수 있는 답을 돌려줍니다. 사람에게는 읽기 쉽게, 에이전트에게는 구조화된 JSON으로.

레이스 보기
도구 호출
21 → 3왕복 18회 감소
에이전트가 작성하는 셸
28× 감소664 → 24 토큰
속도 향상
1.9×26.4 s → 13.6 s

일상적인 진단 3가지를 같은 기기에서 같은 날 측정했습니다. 측정 방법

QZX / 기록된 예시
qzx diagnoseProject . --json

수정하기 전에 이해하기

프로젝트 브리핑을 하나의 명령으로.

기술Python
선언된 패키지httpx
1건의 발견 사항

Git 저장소가 감지되지 않았습니다.

다음 점검pytest · ruff구성됨 · 실행 안 함
JSON 확인
{
    "success": true,
    "details": {
        "technologies": [
            "Python"
        ],
        "dependencies": {
            "unique_declared_package_count": 1,
            "unique_packages": [
                "httpx"
            ]
        },
        "version_control": {
            "status": "not_repository"
        },
        "file_scan": {
            "scanned_file_count": 3,
            "scan_complete": true
        },
        "summary": {
            "issue_count": 1,
            "verification": {
                "release_readiness": "not_assessed"
            }
        },
        "validation": {
            "tests": {
                "status": "configured_not_run"
            },
            "lint": {
                "status": "configured_not_run"
            }
        }
    }
}

기록된 샘플: project-doctor. 실제 결과에서 선택한 필드.

문서화 파이프라인이 기록한 결과입니다. JSON은 검토된 발췌본입니다. 결과 계약 살펴보기

설치하고, 확인하면, 준비 완료.Alpha 0.2.2.0.15
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
격리된 설치를 원하시나요?

pipx를 사용하면 QZX를 프로젝트의 Python 의존성과 분리할 수 있습니다.

무료 오픈 소스 · 계정 불필요 · Alejandro Sánchez

모든 기기에서 같은 명령 체계.

WindowsLinuxmacOS

에이전트의 터미널에 자연스럽게.

CodexClaude CodeGemini CLI

상상이 아닌 측정

같은 증거,
하나의 명령.

같은 기기에서 각 진단을 두 가지 방식으로 실행했습니다. 에이전트가 도구 호출마다 하나씩 입력하는 네이티브 명령과, 단 하나의 QZX 명령입니다. 작업을 골라 레이스를 확인하세요.

QZX 없이 · PowerShell10개 명령 · 10.3 s
  1. git -C '.' status --short --branch
  2. git -C '.' log --oneline -5
  3. git -C '.' remote -v
  4. Get-ChildItem '.' -Recurse -File | Where-Object FullName -notmatch '\\.git\\' | Group-Object Extension | Sort-Object Count -Descending | Select-Object -First 10 Name,Count
  5. Get-ChildItem '.' -File | Where-Object Name -in 'pyproject.toml','setup.py','setup.cfg','requirements.txt','package.json','Cargo.toml','go.mod','composer.json' | Select-Object Name
  6. Get-Content './pyproject.toml'
  7. Get-ChildItem '.' -File | Where-Object Name -in 'pytest.ini','tox.ini','ruff.toml','.ruff.toml','Makefile','noxfile.py' | Select-Object Name
  8. python --version
  9. Get-ChildItem '.' -Recurse -File | Where-Object FullName -notmatch '\\.git\\' | Sort-Object Length -Descending | Select-Object -First 10 FullName,Length
  10. Get-ChildItem '.' -Recurse -File -Include *.py | Select-String -Pattern 'TODO|FIXME' | Measure-Object | Select-Object Count
…Linux (10) 와 macOS (10) 에서는 문법이 또 다릅니다

Linux

  1. git status --short --branch
  2. git log --oneline -5
  3. git remote -v
  4. find . -type f -not -path './.git/*' | sed -n 's/.*\.//p' | sort | uniq -c | sort -rn | head
  5. ls pyproject.toml setup.py setup.cfg requirements.txt package.json Cargo.toml go.mod 2>/dev/null
  6. cat pyproject.toml
  7. ls pytest.ini tox.ini ruff.toml .ruff.toml Makefile noxfile.py 2>/dev/null
  8. python3 --version
  9. find . -type f -not -path './.git/*' -printf '%s %p\n' | sort -rn | head
  10. grep -rIn --include='*.py' -E 'TODO|FIXME' . | wc -l

macOS

  1. git status --short --branch
  2. git log --oneline -5
  3. git remote -v
  4. find . -type f -not -path './.git/*' | sed -n 's/.*\.//p' | sort | uniq -c | sort -rn | head
  5. ls pyproject.toml setup.py setup.cfg requirements.txt package.json Cargo.toml go.mod 2>/dev/null
  6. cat pyproject.toml
  7. ls pytest.ini tox.ini ruff.toml .ruff.toml Makefile noxfile.py 2>/dev/null
  8. python3 --version
  9. find . -type f -not -path './.git/*' -exec stat -f '%z %N' {} + | sort -rn | head
  10. grep -rIn --include='*.py' -E 'TODO|FIXME' . | wc -l

10 개의 조각을 첫 수정 전에 이어 붙여야 합니다.

QZX 사용 · 모든 OS1개 명령 · 8.0 s
qzx diagnoseProject .
  • 기술 스택
  • 의존성
  • 환경
  • 테스트 및 lint
  • Git 상태
  • 소스 분석
  • 대용량 파일
  • 발견 사항

1.3× 더 빠름. 발견 사항과 다음에 실행할 점검을 담은 하나의 브리핑.

측정 방법: 2026-10-08, Windows 11 10.0.26200에서 QZX 0.2.2.0.14로 측정했습니다. 각 네이티브 명령은 에이전트의 개별 도구 호출처럼 새 PowerShell 7 프로세스에서 실행했으며, 네이티브 쪽에 유리하도록 열 선택을 최소화했습니다. 토큰은 tiktoken o200k_base으로 계산했습니다. Linux와 macOS 명령은 참고용이며 시간을 측정하지 않았습니다. QZX 결과에는 점수, 실패 계층, 권장 사항 같은 결론도 포함되지만, 네이티브 출력에서는 에이전트가 직접 추론해야 합니다.

작동 방식

에이전트는 한 번만 요청하고, 플랫폼 차이는 QZX가 처리합니다.

QZX는 오픈 소스 Python CLI입니다. 사용자나 에이전트가 문서화된 명령 하나를 호출하면 QZX가 Windows, Linux, macOS별 작업을 처리하고 어디서나 같은 형태로 답합니다. 사람에게는 읽기 쉬운 요약을, 프로그램에는 --json으로 구조화된 JSON을 제공합니다.

  1. 설치

    pip 또는 pipx로 PyPI 패키지 하나만 설치합니다. 계정, 서버, 상주 프로세스가 필요 없습니다.

  2. 작업 요청

    명령 이름으로 호출합니다. 예: qzx inspectPort 3000. 지원되는 모든 시스템에서 같은 철자를 씁니다.

  3. 읽거나 파싱

    사람은 요약을 읽습니다. 에이전트는 --json을 붙여 success를 확인하고 message를 읽고 타입이 있는 근거를 사용합니다.

Codex, Claude Code, Gemini CLI와 스크립트가 Windows, Linux, macOS에서 같은 QZX 명령을 호출하고 공통 success, message, output, meta 필드를 받는 모습을 보여 주는 다이어그램.
문서화된 명령 하나로 여러 호스트에서 지원되는 작업을 처리하면서도 결과의 공통 핵심은 예측 가능하게 유지됩니다. 플랫폼 제약과 명령별 근거는 명시적으로 드러납니다.

개발자와 팀이 바꾸는 이유

빠르게 실행되고, 편하게 쓰고, 오래 쓸 수 있습니다.

턴은 줄이고, 셸도 줄이고, 결과는 더 많이

도구 호출 하나하나가 모델의 턴 하나입니다. QZX는 여러 단계의 진단을 하나로 합쳐, 에이전트가 작성하는 셸을 28× 줄이고(664 → 24 토큰) 왕복을 18회 건너뛰게 합니다. 결론은 이미 계산되어 있습니다.

21 → 3

처음부터 끝까지 더 빠르게

줄줄이 이어지는 셸 대신 하나의 프로세스. 세 가지 진단 전체에서 1.9×, 웹사이트가 다운됐을 때는 3.0× 더 빠릅니다.

3.0×

하나의 명령 체계, 세 개의 OS

더 이상 OS별로 프롬프트를 나누지 마세요.

Resolve-DnsNamedigopenssl s_clientqzx diagnoseWebsite

89개의 공개 명령, 계속 늘어나는 중

시스템, 네트워크, 파일, Git, 개발, 스토리지, 프로젝트 스캐폴딩까지 한 번의 설치로.

도구 둘러보기

기본적으로 안전

진단은 읽기 전용입니다. 무언가를 바꾸는 명령은 먼저 미리 보기를 보여 주고 백업과 승인 장치를 유지합니다.

보안 및 원격 측정

에이전트가 믿을 수 있는 계약

모든 --json 결과에는 명시적인 success와 유용한 message, 그리고 타입이 있는 증거가 담깁니다. 표를 긁어 오거나 종료 코드로 추측할 필요가 없습니다. 스키마는 공개되어 있고 내려받을 수 있습니다.

결과 계약 살펴보기

실제 문제부터 시작하세요

다음 변경 전에 유용합니다.

눈앞의 작업을 고르세요. 읽기 전용 진단으로 시작한 뒤 다음 단계를 정하면 됩니다.

명령 10개 대체

낯선 프로젝트를 익숙하게.

에이전트가 수정을 시작하기 전에 기술 스택, 의존성, Git 상태, 구체적인 발견 사항을 파악하세요.

qzx diagnoseProject .
프로젝트 워크플로 살펴보기
파이프라인 3개 대체

디스크를 채우는 원인을 찾으세요.

용량, 대용량 파일, 중복 증거를 살펴보고 무엇이든 지우기 전에 선택지를 파악하세요.

qzx diagnoseStorage .
스토리지 워크플로 살펴보기
명령 8개 대체

“사이트가 다운됐어요” 그다음으로.

DNS, 인증서, HTTP를 한 번에 확인하고 증거를 따라 다음 점검으로 넘어가세요.

qzx diagnoseWebsite <url>
웹사이트 워크플로 살펴보기

누구나 구현할 수 있는 열린 계약

문장을 해석하지 않아도 에이전트가 믿을 수 있는 답

모든 JSON 결과에는 명시적인 불리언 success와 비어 있지 않은 유용한 message가 있습니다. 그다음 각 명령이 타입이 있는 근거를 덧붙입니다. 여기서는 실제 인증서 검사 결과입니다. 에이전트가 해석해야 하는 긴 텍스트가 아닙니다.

{
  "success": true,
  "message": "SSL certificate diagnostic for 'example.com:443': …",
  "host": "example.com",
  "is_valid": true,
  "chain_trusted": true,
  "hostname_match": true,
  "days_remaining": 78,
  "ssl_version": "TLSv1.3",
  "subject_alt_names": ["example.com", "*.example.com"],
  "meta": { "command": "checkSslCertificate", "duration_ms": 216.817, "schema_version": 1 }
}

2026년 10월 8일 실제로 실행한 qzx checkSslCertificate example.com --json의 일부입니다.

키보드 양쪽 모두를 위해

터미널 앞의 개발자를 위해. 장비 군을 운영하는 기업을 위해.

개발자

에이전트에게 오래가는 규칙 하나: QZX를 먼저 쓰기.

  • Codex, Claude Code, Gemini CLI 등 터미널이 있는 모든 에이전트에서 작동합니다.
  • 같은 지시가 Windows 노트북과 Linux 서버에서 모두 통합니다.
  • 직접 실행하면 읽기 쉬운 출력, 에이전트가 실행하면 엄격한 JSON.
5분 만에 AI 에이전트 설정하기

기업

에이전트가 기기를 점검하는 방식을 표준화하세요.

  • Windows, Linux, macOS 전반에 걸친 감사 가능한 하나의 명령 체계.
  • 자동화가 기록하고, 비교하고, 활용할 수 있는 구조화된 증거.
  • Apache-2.0, 계정 불필요, 종속 없음. 제작자에게 맞춤 통합을 의뢰할 수 있습니다.
사용 사례 상담하기

더 알아보기

설치를 결정하기 위한 가이드

한계를 알고 QZX를 선택하세요

QZX는 로컬 명령 인터페이스이며, 샌드박스도 아니고 네이티브 도구와 완전히 같다는 보장도 아닙니다. 문서화된 명령이 작업을 다루고 일관된 결과 계약이 도움이 될 때 QZX를 선택하세요. QZX가 다루지 않는 기능에는 네이티브 API나 셸을 사용하세요.

PyPI 공개 버전: QZX 0.2.2.0.15 · wheel에 기능 89개 · Python >=3.11

호기심에서 터미널로

다음 명령은 QZX 명령으로.

공개 릴리스를 설치하고 첫 점검을 실행한 뒤, 예전엔 10번 걸리던 일을 에이전트가 한 번의 호출로 하게 하세요.