Quetta Inline Assist
이미 쓰고 있는 코딩 에이전트 CLI 로 VS Code 안에서 코드를 제안받습니다. 별도의 API 키가 필요 없고,
설치된 에이전트의 로그인과 설정을 그대로 씁니다.
Anthropic · OpenAI · Alibaba 의 공식 확장이 아닙니다. Quetta Soft 가 만든 비공식 확장입니다.
기능
| 기능 |
단축키 |
설명 |
| 자동 제안 |
— |
타이핑을 멈추면 커서 위치에 흐린 글씨로 제안, Tab 으로 수락 |
| 지시로 수정 |
ctrl+alt+i |
선택 영역(없으면 파일 전체)에 지시를 주고 diff 로 확인 후 수락 |
| 큰 제안 |
ctrl+alt+enter |
넓은 문맥으로 여러 줄 제안 |
| 에이전트 선택 |
— |
명령 팔레트 Quetta: 에이전트 선택 |
요구 사항
아래 중 하나 이상이 설치돼 있고 로그인돼 있어야 합니다.
| 에이전트 |
설치 |
확장이 실행하는 명령 |
| Claude Code |
claude |
claude -p --input-format stream-json … |
| Qwen Code |
qwen |
qwen --acp |
| OpenCode |
opencode |
opencode acp |
| Codex |
codex + npx |
npx -y @zed-industries/codex-acp |
| 그 밖의 ACP 에이전트 |
각자 |
quettaInline.agents 에 명령을 적으면 됩니다 |
설정
| 키 |
기본값 |
설명 |
quettaInline.agent.auto |
claude |
자동 제안에 쓸 에이전트 |
quettaInline.agent.task |
claude |
명령에 쓸 에이전트 |
quettaInline.agents |
{} |
사용자 정의 에이전트 { "id": { "command": "…", "args": ["--acp"] } } |
quettaInline.auto.enabled |
true |
자동 제안 사용 |
quettaInline.auto.model |
claude-opus-5 |
Claude 백엔드 모델 |
quettaInline.auto.effort |
low |
Claude 백엔드 effort |
quettaInline.auto.debounceMs |
500 |
입력이 멈춘 뒤 요청까지 기다리는 시간 |
quettaInline.task.model |
"" |
명령용 Claude 모델(비우면 기본) |
quettaInline.cli.path |
~/.local/bin/claude |
claude 실행 파일 |
quettaInline.cli.configDir |
"" |
CLAUDE_CONFIG_DIR 로 전달할 설정 폴더 |
quettaInline.context.linesBefore / .linesAfter |
200 / 50 |
보낼 문맥 줄 수 |
quettaInline.excludeGlobs |
.env·키·인증서 등 |
제안하지 않을 파일 |
안전
- ACP 에이전트가 파일 수정이나 명령 실행 권한을 요청하면 항상 거절합니다. 확장은 코드 텍스트만 받습니다.
.env, *.pem, *.key, secrets/, id_rsa 파일에서는 제안하지 않습니다.
- 출력 창에는 소요 시간과 오류만 기록하고 코드·프롬프트 본문은 남기지 않습니다.
알려진 제약
- Windows:
qwen·opencode·npx 는 Windows 에 설치돼 있어도 실제 실행 파일은 .cmd/.bat
셸 스크립트인 경우가 많습니다. quettaInline.agents 의 command 에 그 .cmd 파일의 전체 경로를
적어도 동작하지 않습니다 — Node 18.20/20.12/22 이상은 shell 옵션 없이 .cmd/.bat 를 spawn 하면
EINVAL 을 던지고(CVE-2024-27980 대응), 이 확장은 항상 shell 없이 spawn 합니다. EINVAL 은 이
확장이 일시정지 사유로 분류하는 ENOENT/EACCES 에 들지 않아 아무 알림 없이 매 요청마다 조용히
실패만 반복됩니다. 우회하려면 command 에 node.exe 실행 파일 경로를, args 에 에이전트
CLI 의 진입점 .js 파일 경로 + 필요한 인자(예: ["--acp"])를 직접 지정하세요. Windows 에서는
검증하지 않았습니다 — 위는 Node 의 공개된 동작에 근거한 판단이며, 이 확장을 Windows 에서 실제로
실행해 확인한 것은 아닙니다.
- ACP 에이전트의 세션 기록: 자동 제안은 요청마다 새
session/new 를 만들고, ACP 프로토콜에는 세션을
닫는 호출이 없습니다. 에이전트에 따라 자체 세션 기록에 보낸 코드 조각이 남을 수 있으며, 이 확장
쪽에서는 이를 막을 수단이 없습니다.
- Codex 첫 실행:
npx -y 로 @zed-industries/codex-acp 를 처음 내려받는 동안 자동 제안의 요청
예산(15초)을 넘겨 실패할 수 있습니다. 처음 쓸 때는 ctrl+alt+i(지시로 수정, 예산 120초)로 먼저
실행해 패키지를 받아두는 것을 권합니다.
법적 고지 · 면책
이 확장은 사용자의 컴퓨터에 이미 설치된 코딩 에이전트 CLI 를 대신 실행해 주는 도구입니다. 모델을
직접 제공하지 않고, 자체 서버도 운영하지 않습니다. 아래 내용에 동의하는 범위에서 사용하세요.
제휴 관계 없음. Quetta Soft 는 Anthropic, OpenAI, Alibaba Cloud, OpenCode, Zed Industries 를 비롯한
어떤 에이전트 제공자와도 제휴·후원·보증 관계가 없습니다. 이 확장은 그들의 공식 제품이 아니며 그들이
검수하거나 지원하지 않습니다. Claude·Claude Code, OpenAI·Codex, Qwen, OpenCode 를 비롯한
모든 상표와 제품명은 각 소유자의 재산이며, 여기서는 호환되는 대상을 가리키기 위한 설명적 용도로만
사용합니다.
CLI 이용에 대한 책임은 사용자에게 있습니다. 각 에이전트 CLI 의 설치·로그인·구독·요금·사용량 한도와
그 이용약관 준수는 전적으로 사용자 책임입니다. 이 확장은 사용자가 설정한 명령을 그대로 실행할 뿐이며,
특정 CLI 가 계속 제공되는지, 약관이 그 사용을 허용하는지, 요금이 어떻게 부과되는지에 대해 Quetta Soft 는
아무런 보장을 하지 않고 책임도 지지 않습니다. 업무용·상용 환경에서 쓰기 전에 해당 제공자의 약관을
직접 확인하세요.
코드는 사용자가 지정한 에이전트로 전달됩니다. 이 확장은 편집 중인 파일의 일부(설정한 문맥 줄 수)와
지시문을 사용자가 고른 CLI 프로세스에 표준 입출력으로 넘깁니다. 그 이후의 전송·처리·보관은 그 CLI 와
그 제공자의 정책을 따르며 이 확장의 통제 밖입니다. Quetta Soft 는 사용자의 코드·프롬프트·응답을
수집하거나 저장하거나 전송받지 않습니다. 기밀 코드를 다룬다면 사용하는 에이전트의 데이터 처리 정책을
먼저 확인하고, quettaInline.excludeGlobs 로 제외 대상을 넓히세요.
생성 결과의 검증은 사용자 책임입니다. 에이전트가 만든 코드의 정확성·보안성·성능은 보장되지 않으며,
제3자 저작물과 유사한 코드가 생성될 가능성도 배제할 수 없습니다. 적용 전에 검토하고, 라이선스·규정
준수 여부를 직접 확인하세요.
실행 파일을 실행하는 확장입니다. quettaInline.agents·cli.path 에 적힌 명령을 그대로 실행하므로,
신뢰할 수 없는 저장소를 열 때는 VS Code 의 Workspace Trust 를 유지하세요(이 설정들은
machine-overridable 로 지정해 워크스페이스 설정이 덮어쓰지 못하게 해 두었습니다).
무보증 · 책임 제한. 이 소프트웨어는 "있는 그대로(AS IS)" 제공되며, 상품성·특정 목적
적합성·비침해를 포함한 어떠한 명시적·묵시적 보증도 하지 않습니다. 이 소프트웨어의 사용 또는
사용 불능으로 발생한 직접·간접·부수적·결과적 손해(데이터 손실, 코드 손상, 사용량 요금, 서비스 중단을
포함하되 이에 한정되지 않음)에 대해 Quetta Soft 와 기여자는 책임지지 않습니다.
라이선스. 저작권은 Quetta Soft 에 있습니다. 이 확장을 설치해 사용하는 것은 허용되며, 복제·수정·
역공학·재배포·재라이선스·판매는 사전 서면 허가 없이는 허용되지 않습니다. 전문은 LICENSE 를 보세요.
전문: https://quetta-soft.com/quetta-inline-assist
문제 해결
| 상태 표시줄 |
뜻 |
조치 |
로그인 필요 |
에이전트 CLI 가 로그인돼 있지 않음 |
터미널에서 해당 CLI 로 로그인 후 상태 표시줄 클릭 |
한도 — N분 후 재개 |
사용량 한도 |
표시된 시간만큼 기다리거나 다른 에이전트 선택 |
CLI 반복 종료 |
프로세스가 반복해서 종료됨 |
터미널에서 같은 명령을 직접 실행해 원인 확인 후 클릭해 재시도 |
실행 파일 없음 |
명령을 찾지 못함 |
quettaInline.cli.path 또는 quettaInline.agents 의 command 확인 |
자세한 기록은 명령 팔레트 Quetta: 로그 보기.