Amazon Q CLI 명령 참조 - Amazon Q Developer
전역 인수명령로그 파일

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Q CLI 명령 참조

이 섹션에서는 모든 Amazon Q Developer CLI 명령 및 해당 인수에 대한 포괄적인 참조를 제공합니다. 이 참조를 사용하여 각 명령에 사용할 수 있는 옵션과 해당 구문을 이해합니다.

명령에 도움이 필요하면 --help 플래그를 사용할 수 있습니다.

q [COMMAND] --help

전역 인수

다음 인수는 모든 Amazon Q CLI 명령에서 사용할 수 있습니다.

전역 인수
인수 짧은 형식 설명
--verbose -v 로깅 세부 정보를 늘립니다. 보다 자세한 출력을 위해 반복할 수 있음: -v, -vv, -vvv, -vvvv
--help -h 명령에 대한 도움말 정보 표시
--version -V 버전 정보 표시
--help-all 모든 하위 명령에 대한 도움말 인쇄

명령

다음 섹션에서는 각 Amazon Q CLI 명령과 사용 가능한 인수를 설명합니다.

Q 채팅

Amazon Q로 대화형 채팅 세션을 시작합니다. 하위 명령을 지정하지 않으면 q 기본값은 입니다q chat.

구문: 

q chat [OPTIONS] [INPUT]
Q 채팅 인수
인수 짧은 형식 설명
--no-interactive 대화형 모드 없이 STDOUT에 대한 첫 번째 응답을 인쇄합니다. 를 사용하지 않는 한 프롬프트가 도구 사용 권한을 요청하면 실패--trust-all-tools합니다.
--resume -r 이 디렉터리에서 이전 대화 재개
--profile 사용할 컨텍스트 프로파일
--trust-all-tools 모델이 확인을 요청하지 않고 모든 도구를 사용하여 명령을 실행하도록 허용
--trust-tools 지정된 도구 집합만 신뢰합니다. 쉼표로 구분된 도구 이름 목록을 제공합니다. 예시: --trust-tools=fs_read,fs_write. 도구를 신뢰하지 않으려면를 사용합니다. --trust-tools=
INPUT 첫 번째 질문(위치 인수)

예: 

q chat
q chat "How do I list files in Linux?"
q chat --no-interactive --trust-all-tools "Show me the current directory"
q chat --resume
q chat --profile my-profile "Help me with AWS CLI"

Q 번역

AI를 사용하여 자연어 지침을 실행 가능한 셸 명령으로 변환합니다.

구문: 

q translate [OPTIONS] [INPUT...]
Q 인수 번역
인수 짧은 형식 설명
--n -n 생성할 완료 횟수( ≤5여야 함)
INPUT 생성하려는 명령의 자연어 설명(위치 인수)

예: 

q translate "list all files in the current directory"
q translate "find all Python files modified in the last week"
q translate "compress all log files older than 30 days"

Q 의사

Amazon Q의 일반적인 설치 및 구성 문제를 수정하고 진단합니다.

구문: 

q doctor [OPTIONS]
Q 의사 인수
인수 짧은 형식 설명
--all -a 수정 없이 모든 의사 테스트 실행
--strict -s 경고 오류

예: 

q doctor
q doctor --all
q doctor --strict

Q 업데이트

Amazon Q 애플리케이션을 최신 버전으로 업데이트합니다.

구문: 

q update [OPTIONS]
Q 업데이트 인수
인수 짧은 형식 설명
--non-interactive -y 확인 메시지를 표시하지 않음
--relaunch-dashboard 업데이트 후 대시보드로 다시 시작합니다. 기본값은 true입니다.
--rollout 롤아웃 사용

예: 

q update
q update --non-interactive
q update --rollout

Q 테마

자동 완성 드롭다운 메뉴의 시각적 테마를 가져오거나 설정합니다. 이는 명령 완료를 보여주는 팝업 창의 모양에 영향을 줍니다.

구문: 

q theme [OPTIONS] [THEME]
Q 테마 인수
인수 설명
--list 사용 가능한 모든 테마 나열
--folder 테마 디렉터리 경로 표시
THEME 설정할 테마의 이름입니다. 기본 제공 테마에는 dark, light, system (위치 인수)가 포함됩니다.

예: 

q theme --list
q theme --folder
q theme dark
q theme light
q theme system

참고: 테마 변경 사항은 자동 완성 팝업 창에 영향을 줍니다. 시각적 변경 사항을 보려면 자동 완성 제안을 트리거해야 할 수 있습니다.

Q 통합

Amazon Q의 시스템 통합을 관리합니다.

구문: 

q integrations [SUBCOMMAND] [OPTIONS]

Q 통합 하위 명령

Q 통합 하위 명령
하위 명령 설명
install 통합을 설치합니다. 상태 메시지를 억제하기 위한 --silent ( -s) 지원
uninstall 통합을 제거합니다. 상태 메시지를 억제하기 위한 --silent ( -s) 지원
reinstall 통합을 다시 설치합니다. 상태 메시지를 억제하기 위한 --silent ( -s) 지원
status 통합 상태를 확인합니다. 출력 형식에 대해 --format ( -f) 지원

Q 인라인

입력 시 명령줄에 직접 나타나는 인라인 제안(고스트 텍스트)을 관리합니다. 자세한 내용은 명령줄 지원 기능 섹션을 참조하세요.

구문: 

q inline [SUBCOMMAND] [OPTIONS]

Q 인라인 하위 명령

Q 인라인 하위 명령
하위 명령 설명
enable 입력 시 표시되는 인라인 제안 활성화
disable 인라인 제안 비활성화
status 인라인 제안의 활성화 또는 비활성화 여부 표시
set-customization 사용할 사용자 지정 모델을 선택합니다. 선택적으로 사용자 지정의 ARN을 지정합니다.
show-customizations 사용 가능한 사용자 지정 모델을 표시합니다. 출력 형식에 대해 --format ( -f) 지원

예: 

q inline enable
q inline disable
q inline status
q inline set-customization
q inline set-customization arn:aws:codewhisperer:us-east-1:123456789012:customization/example
q inline show-customizations
q inline show-customizations --format json

Q 로그인

AWS Builder ID(무료) 또는 IAM Identity Center(Pro)를 사용하여 Amazon Q로 인증합니다.

구문: 

q login [OPTIONS]
Q 로그인 인수
인수 설명
--license 라이선스 유형. 옵션: free ( Builder ID의 경우), pro (Identity Center의 경우)
--identity-provider 자격 증명 공급자 URL(Identity Center용)
--region AWS 리전(Identity Center용)
--use-device-flow 인증에는 항상 OAuth 디바이스 흐름을 사용합니다. 브라우저 리디렉션을 처리할 수 없는 경우에 유용합니다.

예: 

q login
q login --license free
q login --license pro --identity-provider https://my-company.awsapps.com/start --region us-east-1
q login --use-device-flow

Q 로그아웃

Amazon Q 세션에서 로그아웃합니다.

구문: 

q logout

이 명령은 추가 인수를 사용하지 않습니다.

Q 와미

현재 사용자 및 인증 상태에 대한 정보를 표시합니다.

구문: 

q whoami [OPTIONS]
Q whoami 인수
인수 짧은 형식 설명
--format -f 출력 형식입니다. 옵션: plain (기본값), json, json-pretty

Q 프로파일

현재 IAM Identity Center 사용자와 연결된 프로필을 표시합니다. 이 명령은 Pro 사용자만 사용할 수 있습니다.

구문: 

q profile

이 명령은 추가 인수를 사용하지 않습니다.

Q 설정

Amazon Q 구성 설정을 관리합니다. 설정 관리에 대한 자세한 내용은 섹션을 참조Amazon Q 설정 구성하세요.

구문: 

q settings [SUBCOMMAND] [OPTIONS] [KEY] [VALUE]
Q 설정 인수
인수 짧은 형식 설명
--delete -d 설정 삭제
--format -f 출력 형식입니다. 옵션: plain (기본값), json, json-pretty
KEY 키 설정(위치 인수)
VALUE 설정 값(위치 인수)

Q 설정 하위 명령

Q 설정 하위 명령
하위 명령 설명
open 기본 편집기에서 설정 파일을 엽니다.
all 현재 설정을 모두 나열합니다. 지원 --format 옵션

Q 진단

진단 테스트를 실행하여 Amazon Q 설치 및 구성 문제를 해결합니다.

구문: 

q diagnostic [OPTIONS]
Q 진단 인수
인수 짧은 형식 설명
--format -f 출력 형식입니다. 옵션: plain (기본값), json, json-pretty
--force 제한된 진단 출력 강제 적용

Q 문제

Amazon Q 피드백 또는 버그 보고서에 대한 새 GitHub 문제를 생성합니다.

구문: 

q issue [OPTIONS] [DESCRIPTION...]
Q 문제 인수
인수 짧은 형식 설명
--force -f 강제 문제 생성
DESCRIPTION 문제 설명(위치 인수)

Q 버전

버전 정보를 표시하고 선택적으로 변경 로그를 표시합니다.

구문: 

q version [OPTIONS]
Q 버전 인수
인수 설명
--changelog[=VERSION] 변경 로그를 표시합니다. --changelog 현재 버전, --changelog=all 모든 버전 또는 특정 버전--changelog=x.x.x에 사용

Q mcp

모델 컨텍스트 프로토콜(MCP) 서버를 관리합니다. MCP에 대한 자세한 내용은 섹션을 참조Amazon Q Developer에서 MCP 사용하세요.

구문: 

q mcp [SUBCOMMAND] [OPTIONS]

Q mcp 추가

구성된 MCP 서버를 추가하거나 교체합니다.

구문: 

q mcp add [OPTIONS]
Q mcp 인수 추가
인수 설명
--name 서버 이름(필수)
--command 서버를 시작하는 데 사용되는 명령(필수)
--scope 서버를 추가할 위치입니다. 옵션: workspace, global
--env 서버를 시작할 때 사용할 환경 변수입니다. 형식: key1=value1,key2=value2
--timeout 밀리초 단위의 서버 시작 제한 시간
--force 동일한 이름으로 기존 서버 덮어쓰기

Q mcp 제거

MCP 구성에서 서버를 제거합니다.

구문: 

q mcp remove [OPTIONS]
Q mcp 인수 제거
인수 설명
--name 제거할 서버의 이름(필수)
--scope 제거할 범위입니다. 옵션: workspace, global

Q mcp 목록

구성된 MCP 서버를 나열합니다.

구문: 

q mcp list [SCOPE]
Q mcp 목록 인수
인수 설명
SCOPE 나열할 범위입니다. 옵션: workspace, global (위치 인수)

Q mcp 가져오기

다른 파일에서 서버 구성을 가져옵니다.

구문: 

q mcp import [OPTIONS] [SCOPE]
Q mcp 가져오기 인수
인수 설명
--file 에서 서버 구성을 가져올 파일(필수)
--force 동일한 이름으로 기존 서버 덮어쓰기
SCOPE 가져올 범위입니다. 옵션: workspace, global (위치 인수)

Q mcp 상태

구성된 MCP 서버의 상태를 가져옵니다.

구문: 

q mcp status [OPTIONS]
Q mcp 상태 인수
인수 설명
--name 상태를 가져올 서버 이름(필수)

로그 파일

Amazon Q Developer CLI는 문제 해결에 유용할 수 있는 로그 파일을 유지합니다. 이러한 로그는 시스템에 로컬로 저장되며 AWS로 전송되지 않습니다.

로그 파일 위치:

  • macOS: $TMPDIR/qlog/

  • Linux: $XDG_RUNTIME_DIR 또는 TMPDIR 또는 /tmp

Q_LOG_LEVEL 환경 변수를 설정하여 로그 수준을 제어할 수 있습니다. 유효한 값은 다음과 같습니다.

  • error: 오류 메시지만(기본값)

  • warn: 경고 및 오류 메시지

  • info: 정보, 경고 및 오류 메시지

  • debug: 디버그, 정보, 경고 및 오류 메시지

  • trace: 세부 추적 정보를 포함한 모든 메시지

주의

로그 파일에는 파일 경로, 코드 조각 및 명령 출력을 포함하여 Amazon Q와의 대화 및 상호 작용에서 얻은 민감한 정보가 포함될 수 있습니다. 이러한 로그는 로컬 시스템에만 저장되고 AWS로 전송되지는 않지만 다른 사람과 로그 파일을 공유할 때는 주의해야 합니다.

로그 수준 설정 예제(디버깅용): 

# For bash/zsh
export Q_LOG_LEVEL=debug
q chat

# For fish
set -x Q_LOG_LEVEL debug
q chat