CARGO / 검토 문서

공개 정제 전문 / 원문 기준 2026-11-16 / 플랫폼 미구현

이 문서는 당시 기획 검토 기록입니다. 문서의 ‘웹 제작 승인 전·공개 금지’ 상태는 이번 임시 검토 웹에 한해 후속 승인으로 대체됐습니다. 사업·실제 플랫폼·유료 생성·발행은 미승인/미검증 상태를 유지합니다. 원문 캡처·내부 위치·협업/계정 식별자와 실행 예시는 공개하지 않습니다.

← 검토 허브통합 검토본10분야·근거
이 문서 목차

06 — 에이전트 CLI·생성 제공자 계약 감사

> 편성 보존 정정: 아래의 ‘optional’, ‘생산 필수 경로 제외’, ‘대체 후보’는 현재 실행 승인/검증을 보류한다는 뜻으로만 읽는다. 원문 4개 CLI 편성을 선택사항으로 변경하거나 삭제한 것이 아니다. 해당 단계의 필수 도구가 미검증/불가라면 blocker로 남기며, 대체·생략은 원 요구·사유·비용/품질/일정 영향·종료일을 기록해 사용자/팀의 별도 예외 승인을 받아야 한다. 이 보고서 자체는 새 편성 승인도 실제 실행 완료도 아니다.

범위·판정

1. 4개 에이전트 CLI: 문서·기기·실행을 분리

CLI D: 공식 문서 기능 H: 이 기기 help 관찰 L: 실제 headless 작업 구조출력 계약·권한 판정
Claude Code claude -p 비대화형, --output-format json/stream-json, --json-schema 구조출력, structured_output 필드. headless에서 승인이 필요한 호출은 별도 승인 수단이 없으면 거부. 문서상 v2.1.302 이후 명시하지 않으면 print가 Manual로 시작.[1] 부모 관찰 버전 2.1.318. claude --help exit 0. -p, --json-schema, --output-format, --allowedTools, --disallowedTools, --permission-mode, --permission-prompts none, --max-budget-usd 존재. 이 버전 permission-mode 값은 manual이며 오래된 예시의 default를 그대로 복사하지 말 것. --bare는 OAuth를 읽지 않음. 미실행: 로그인·모델 접근·스키마 실제 이행·stdout/파일 일치·비용·종료코드 미검증 JSON envelope와 최종 업무 산출물은 다르다. structured_output에서 업무 스키마를 별도로 검사. --allowedTools는 지정 도구 자동승인 성격이며 OS 격리가 아니다. --dangerously-skip-permissions를 기본계약으로 삼지 말 것.
Codex CLI codex exec 비대화형, --json JSONL 이벤트, --output-schema 최종 응답 JSON Schema, -o 최종 응답 파일. 저장 인증 재사용 및 자동화 인증 경로 공식 기술.[3] 부모 관찰 버전 0.166.0. codex exec --help exit 0. 위 옵션과 --sandbox read-only/workspace-write/danger-full-access, --approve-for-me, --skip-git-repo-check, --ephemeral 관찰. 미실행: 실제 모델·샌드박스 강제·스키마·출력 파일·종료 이벤트 미검증 --json 이벤트 스트림을 최종 업무 JSON으로 취급하면 안 됨. -o 파일을 검증하고 turn.completed/turn.failed 등을 기록. --approve-for-me는 workspace-write 자동심사 경로이지 read-only 옵션 아님. help에 없는 오래된 --full-auto를 끼워넣지 말 것.
Antigravity CLI Google 공식 codelab이 agy -p "…"를 스크립트/자동화용 비대화형 호출로 명시하고 --model도 설명. 초기 로그인·약관 동의·폴더 read/edit/execute 신뢰승인 흐름도 설명.[7] 부모에서 agy가 PATH에 없다는 관찰만 있음. 설치 여부, 설치 버전, agy --help는 미확인. 미실행. TTY 없는 stdout 문제 해결 여부·timeout·파일 산출물 미검증 agy -p 자체를 추정 명령으로 낮출 필요는 없음(D 확인). 반면 원본의 --output-format json·--print-timeout 10m은 이 감사에서 D/H 모두 공식 미검증. 닫힌 이슈만으로 재현 성공 판정 금지. 기계 판독 가능한 adapter 선정은 보류.
Grok Build 이번 bounded 감사에서 독립적인 Grok Build 공식 headless 설명·자동화 약관 본문은 미확보. xAI 이미지 문서를 CLI 문서로 대체하지 않음. 부모 관찰 버전 1.0.70, grok --help exit 0. -p, --single <PROMPT> stdout 출력 후 종료. --output-format plain/json/streaming-json/streaming-messages-json, --json-schema, --max-turns, --allow, --deny, --permission-mode, --sandbox, --disable-web-search 관찰. agent 하위명령도 존재. 미실행: 모델 목록, 실제 웹 검색, 구조출력, OAuth/API 과금, sandbox 프로필 미검증 grok -p는 적어도 H 확인. “실시간 검색이 됨”은 help의 검색 비활성화 옵션만으로 검증되지 않음. 원본 --always-approve는 모든 도구 실행 자동승인이므로 기본계약에서 제거 제안. sandbox 프로필 값도 별도 확인 필요.

H 원자료: 비공개 검증 기록(웹 미포함), claude-help.txt, codex-exec-help.txt, grok-help.txt. 세 help 캡처 시간은 부모 로그상 2026-11-16 13:16 KST다. 버전은 부모가 전달한 관찰값이며 이 lane에서 재실행하지 않았다.

2. 구독 자동화·자격증명·라이선스: 기술적 가능성과 계약 허용을 분리

제공자/경로 공식 확인 범위 구독 기반 무인 운영·권한 라이선스·비용 확인 상태 Cargo 결정
Claude Code 네이티브 CLI Free/Pro/Max/Ultra는 Consumer Terms, Team/Enterprise/API는 Commercial Terms 적용. OAuth는 구독자의 보통 native 사용 용도. 제품·서비스/Agent SDK 개발자는 API key 또는 지원 cloud provider 사용을 안내.[2] 공식 본문은 수정하지 않은 CLI에 최종사용자가 자신의 구독으로 로그인하는 hosting 가능성을 명시한다. 동시에 제3자가 고객 대신 Free/Pro/Max/Ultra credential로 라우팅하거나 Claude.ai credential/session token을 수집·저장·중개하는 것은 금지한다.[2] 내부 3인 전용 큐 운영이 어느 범위인지 무조건 허용/금지로 단정하지 않음. 계정 플랜·허용 좌석·구독 사용량·조직 계약 미열람. --bare는 OAuth를 안 쓰므로 “구독만 있는 계정” 설계와 양립하지 않음(H/[1]). 출력의 상업권·보증·면책 조항 전문은 미검증. 사람별 계정/좌석과 네이티브 CLI 원형을 유지할지, 조직/API 경로로 갈지 먼저 결정. 토큰 공유 풀·사용자 대신 구독 프록시는 설계 금지. 내부 큐 적합성은 계약 담당자 확인 전 조건부.
Codex 네이티브 CLI 공식 자동화 문서는 API key를 기본 권고하고 ChatGPT-managed auth in CI/CD (advanced)도 별도 경로로 설명. trusted runner 필요, auth.json은 비밀번호처럼 취급하고 public/open-source repo에는 그 workflow를 쓰지 말라고 명시.[3] 그러므로 “구독 자동화는 모두 금지”도 “구독이면 제한 없는 로봇 계정”도 잘못이다. 특정 플랜·계정·좌석 및 저장 인증을 유지하는 계약은 별도 승인 필요. 이 lane은 credential을 읽거나 옮기지 않았다. 현재 계정 접근모델·쿼터·한도·추가 구매·실사용 비용 미검증. 문서의 API key 경로와 구독 쿼터는 별도 예산. 출력 라이선스/상업권 전문 미검증. 검증 가능한 후보. 담당 사용자가 승인한 trusted runner와 credential 보관계약 없이는 예약운영 불가.
Antigravity 공식 codelab은 개인 Gmail, 초기 동의와 폴더 접근 권한 및 자동화용 -p를 설명.[7] headless 지원이 조직 공유계정·구독 자동화 약관을 입증하지 않음. 플랜별 CI/공유러너/자동화 권리·OAuth 보관조건 공식 미검증. 구독 요금·한도·CLI 자체 배포 라이선스·생성물 상업권 미검증. 원문 편성의 미검증 blocker로 보존. 해당 실행은 검증 전 보류하며 대체·생략은 별도 예외 승인 필요.
Grok Build H에서 OAuth 선택·headless·도구 권한 존재. 공식 Build 계약/지원 모델/정산 본문은 미검증. Grok 웹 구독, Grok Build, xAI 이미지 API의 인증·권리·과금이 같다고 가정하지 말 것. 설치 바이너리의 배포 라이선스와 구독 무인 자동화·상업적 산출물 권리·가격 공식 미검증. H는 유효하나 실행·계약은 미검증 blocker. 편성을 삭제하지 않으며 검증 전 실행 보류, 대체·생략은 별도 예외 승인.
GPT Image API 공식 API guide에서 Bearer 인증·생성/편집 endpoint 확인. 일부 조직은 verification이 필요할 수 있음.[4] ChatGPT 구독 로그인만으로 Images API 사용권·무료 쿼터가 생긴다는 근거 없음. API 조직별 권한 확인 필요. 이미지 상업권·배상/면책·독점권·학습/보관 약관 전문은 이번 범위 미검증. 러너 전용 API credential, 승인된 예산·자료권한 확인 후에만 사용.
Grok Imagine API 공식 guide에서 xAI API key·endpoint·응답 확인.[5] Build 구독 또는 Grok 웹 구독이 API 비용을 포함한다고 보장하지 않음. 상업사용·생성물 권리·초상권/참조자료 약관, 계정별 단가·크레딧은 미검증. 별도 provider adapter·API 예산으로 취급.
Higgsfield API 공식 문서가 server-side key ID+secret과 성공요청 잔액 과금을 설명.[8][9][6] 웹/모바일 클라이언트에 secret 금지, dev/prod credential 분리 권고.[9] 웹 구독 크레딧이 공개 API 잔액과 같다는 근거는 이번 본문에 없음. 성공요청 과금, failed/nsfw 미과금 및 예약금 환급, processing 시작 전 취소만 가능, 정상 취소 queued 요청 환급. 보관 7일·잔액 입금 후 1년 만료.[6] 상업라이선스·업스트림 모델별 제한·개인정보/초상권 계약은 미검증. API 계약과 웹/CLI 구독을 섞지 않음. 모델별 권리·보관·견적을 확정해야 영상 단계 승인 가능.

권리 게이트: CLI 패키지 라이선스, 서비스 구독의 자동화 권한, 생성물 이용권은 서로 다른 계약이다. 위 “상업권 미검증”은 이용 금지가 아니라 아직 법무/계약 검증 증거가 없다는 뜻이다. 어떤 제공자의 출력 소유권이 확인되더라도 타인의 캐릭터·상표·초상·참조이미지 권리, 저작권 성립 및 독점성을 자동 보증하지는 않는다(이 문장은 운영상 분리 원칙이지 개별 약관 해석이 아니다).

3. 생성 모델 ID·endpoint·비용 확인표

제공자 원본 식별자 → 이번 D 판정 기계 인터페이스·출력 모델·비용 확인 상태 L
OpenAI GPT Image 원본 gpt-image-2는 공식 guide 본문에서 정확한 토큰으로 확인. 이전모델 절에 설정·입력충실도·비용 설명이 존재. “없다/가짜다” 판정 금지. 같은 페이지의 최신 권장 예시는 2.5와 2.6 계열도 섞이므로 자동으로 새 ID로 바꾸지 않음.[4] POST <https://api.openai.com/v1/images/generations> 및 /v1/images/edits. API guide의 gpt-image-2는 참조이미지 입력을 자동 high fidelity 처리하며 input_fidelity 변경을 허용하지 않는다고 설명.[4] D: 모델 토큰·기능 확인 / 계정 entitlement 미검증. guide의 Historical output costs에서 GPT-Image-2 1024×1024 low $0.006, medium $0.053, high $0.211 표를 확인했으나 현재 계정의 총 요청단가로 승격하지 않음. 입력 텍스트·입력 이미지 비용은 별도이고 현재 가격표 재확인 필요. 참조이미지 최대 수는 공식 미검증.[4] 미실행
xAI Grok Imagine 원본 grok-imagine-image-2.0가 공식 generation guide의 실제 예제 model 값과 일치.[5] POST <https://api.x.ai/v1/images/generations>, Bearer API key. response_format 기본 url은 임시 hosted URL, b64_json 선택 가능. OpenAI 호환 SDK 사용예 제공.[5] D: ID·생성 endpoint·응답 확인 / 계정 entitlement 미검증. 이번 페이지로 실제 USD/장, 해상도별 가격·동시성·쿼터 확인 못함. 검색 발췌 단가는 사용하지 않음. 편집 endpoint·참조 상한도 이 표에서 검증된 것으로 간주하지 않음. 미실행
Higgsfield 공개 API 기본 URL <https://api.higgsfield.ai>, Authorization: Key KEY_ID:SECRET, request_id→status_url 폴링/webhook→completed 다운로드를 공식 확인.[8][9] billing guide는 higgsfield-ai/soul/v2/standard 경로를 estimate 예제로 제시.[6] 모델별 JSON 제출과 비동기 요청 계약. &lt;model&gt;은 실제 ID가 아닌 placeholder. 반환 request_id, status/output, 만료시각을 보존해야 함.[8][6] D: base/auth/lifecycle·예제 경로 확인. Kling 등 Cargo가 실제 쓸 영상모델의 정확한 경로·입력 schema·이용권·단가는 공식 미검증. estimate 예시 {"usd":"0.094"}는 문서 자체가 형식 예시라고 명시하므로 단가에 쓰지 않음. 인증된 동일 파라미터 estimate가 authoritative라는 설명만 확인.[6] estimate·generate 모두 미실행

추가 주의: 로드한 Higgsfield 로컬 skill의 CLI job_set_type(예: gpt_image_2)는 공개 REST 모델 경로와 동일한 ID라고 가정할 수 없다. 이번 감사에서 skill의 모델 카탈로그를 공식 endpoint 증거로 쓰지 않았고 설치·로그인·모델 조회도 하지 않았다.

4. 원본에 반영할 수정 제안 — 구현 아님

  1. “4개 모두 지정 러너에서 headless로 돈다”를 Claude/Codex D+H, Grok H, Antigravity D 확인 / 실제 인증 실행은 네 개 모두 미검증으로 바꾼다. Antigravity는 PATH 미검출이지 미설치 판정이 아니다.
  2. “스키마를 주면 구조가 맞는 JSON만 받는다”는 제공자 구조출력 + 러너의 독립 JSON Schema 검사 + 파일 경로/크기/종료 검증으로 수정한다. JSONL stdout, JSON envelope, 업무 파일을 구별한다.
  3. Grok 기본 명령에서 --always-approve 삭제 제안. Claude의 버전별 manual enum을 기록하고 권한 설정은 도구 allow/deny와 OS/네트워크 격리를 함께 명시한다. 이 lane은 설정을 바꾸지 않았다.
  4. 구독-only 일괄정책 대신 플랜/사용자/러너/자동화 용도별 허용계약을 만든다. Claude credential 중개 금지와 Codex advanced CI 문서를 서로 뭉뚱그리지 않는다.[2][3]
  5. 이미지 ID 두 개는 이번 공식 본문으로 확인되었으므로 “검색 발췌뿐” 상태를 각각 D 확인으로 올릴 수 있다. 실제 계정 사용가능·가격확정·생성성공으로는 올리지 않는다.[4][5]
  6. Higgsfield의 확정된 base/auth/lifecycle는 유지하되 실제 영상모델 endpoint·권리·견적은 pending으로 남긴다. 결과 URL 만료 전에 자체 저장소로 내려받는 계약을 추가한다.[8][9][6]

5. 승인 후 별도 검증할 최소 항목

게이트 필요한 증거 이번 결과
계정·구독 계약 담당자/좌석/플랜/자동화 방식/배포 라이선스/출력 상업권의 공식 조항 및 확인일 부분 문서만 확인; 전면 승인 아님
CLI 실제 실행 승인된 빈 작업폴더에서 최소 프롬프트·명시 권한·timeout, exit/stdout/stderr/schema/artifact 기록 네 개 모두 미실행
모델 접근 조직/계정이 해당 정확한 모델 ID를 사용할 수 있다는 인증된 read-only 조회 또는 승인된 최소생성 미실행
비용 모델·quality·resolution·reference 수·재시도 포함 견적 및 실청구 기록 문서의 비용 구조만 확인, 실제 비용 미검증
부작용/복구 네트워크 allowlist, credential 비노출, 취소·중복제출·만료·재시도·쿼터 처리 설계 제안만, 구현·실험 없음

증거 파일

Sources

[1] https://code.claude.com/docs/en/headless — claude-headless > "To run Claude Code in non-interactive mode, pass -p with your prompt and the CLI options you need: claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash" This page covers using the Agent SDK via the" [2] https://code.claude.com/docs/en/legal-and-compliance — claude-legal > "OAuth authentication is intended exclusively for purchasers of Claude Free, Pro, Max, Ultra, Team, and Enterprise subscription plans and is designed to support ordinary use of Claude Code and other native Anthropic appli" [3] https://developers.openai.com/codex/noninteractive — codex-headless > "Use ChatGPT-managed auth in CI/CD (advanced) Read this if you need to run CI/CD jobs with a Codex user account instead of an API key, such as enterprise teams using ChatGPT-managed Codex access on trusted runners or user" [4] https://developers.openai.com/api/docs/guides/image-generation — openai-images > "gpt-image-2 accepts any resolution in the size parameter when it satisfies the constraints below. Square images are typically fastest to generate. Popular sizes 1024x1024 (square) 1536x1024 (landscape) 1024x1536 (portrai" [5] https://docs.x.ai/developers/model-capabilities/images/generation — xai-images > "grok-imagine-image-2.0" ), prompt: "A collage of London landmarks in a stenciled street‑art style" , }); console. log (image.base64); from openai import OpenAI client = OpenAI( base_url = "https://api.x.ai/v1" , api_key" [6] https://docs.higgsfield.ai/docs/concepts/billing-and-retention — higgs-billing > "Higgsfield charges successful generation requests to your account balance. The exact cost depends on the selected model and parameters. Balance expiration Funds added to your account balance expire one year after they ar" [7] https://codelabs.developers.google.com/antigravity-cli-hands-on — Antigravity CLI official codelab > "You use the -p parameter to provide the prompt to Antigravity CLI as shown below: agy -p "What is the gcloud command to deploy to Cloud Run" This might be a good way to get some quick answers but do keep in mind that the" [8] https://docs.higgsfield.ai/docs/how-to/introduction — Higgsfield API lifecycle > "The Higgsfield API uses an asynchronous request lifecycle: Submit JSON parameters to a model endpoint. Store the returned request_id . Poll status_url or wait for a webhook. Download output when the request becomes compl" [9] https://docs.higgsfield.ai/docs/authentication — Higgsfield API authentication > "Each credential consists of a key ID and a secret. Authorization header Send both values in the Authorization header: Authorization : Key YOUR_KEY_ID:YOUR_KEY_SECRET curl https://api.higgsfield.ai/requests/REQUEST_ID/sta"