Amazon Q CLI 명령 참조 - Amazon Q Developer
글로벌 인수명령로그 파일

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

Amazon Q CLI 명령 참조

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

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

q [COMMAND] --help

글로벌 인수

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

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

명령

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

q chat

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

구문: 

q chat [OPTIONS] [INPUT]
Q chat 인수
인수 짧은 형식 Description
--no-interactive 대화형 모드 없이 STDOUT에 대한 첫 번째 응답을 인쇄합니다. --trust-all-tools를 사용하지 않는 한 프롬프트가 도구 사용 권한을 요청하면 실패합니다.
--resume -r 이 디렉터리에서 이전 대화 재개
--agent 사용할 에이전트
--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 --agent my-agent "Help me with AWS CLI"

q translate

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

구문: 

q translate [OPTIONS] [INPUT...]
q translate 인수
인수 짧은 형식 Description
--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 doctor

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

구문: 

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

예: 

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

q update

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

구문: 

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

예: 

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

q theme

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

구문: 

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

예: 

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

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

q integrations

Amazon Q의 통합을 관리합니다.

구문: 

q integrations [SUBCOMMAND] [OPTIONS]

q integrations 하위 명령

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

q inline

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

구문: 

q inline [SUBCOMMAND] [OPTIONS]

q inline 하위 명령

q inline 하위 명령
하위 명령 Description
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 login

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

구문: 

q login [OPTIONS]
q login 인수
인수 Description
--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 logout

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

구문: 

q logout

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

q whoami

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

구문: 

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

q profile

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

구문: 

q profile

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

q settings

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

구문: 

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

q settings 하위 명령

q settings 하위 명령
하위 명령 Description
open 기본 편집기에서 설정 파일 열기
list 구성된 설정을 나열합니다. --all를 사용하여 설명과 함께 사용 가능한 모든 설정을 표시합니다. --format 옵션 지원
all (사용되지 않음) 현재 설정을 모두 나열합니다. 대신 list을 사용하세요. --format 옵션 지원

/프롬프트

채팅 상호 작용을 위한 재사용 가능한 프롬프트 템플릿을 관리합니다. 프롬프트 관리 및 인수에 대한 자세한 내용은 섹션을 참조하세요프롬프트 관리.

구문: 

/prompts [SUBCOMMAND] [OPTIONS] [NAME] [ARGUMENTS...]
/prompts 인수
인수 Description
NAME 프롬프트 이름(자세한 내용은 명령 생성, 편집, 제거)
ARGUMENTS... get 명령을 사용할 때 프롬프트에 전달할 인수

/prompts 하위 명령

/prompts 하위 명령
하위 명령 Description
list [search-word] 선택적으로 검색어로 필터링된 사용 가능한 프롬프트 나열
details <name> 인수, 사용량 및 예제를 포함하여 프롬프트에 대한 세부 정보 표시
get <name> [args...] 선택적 인수를 사용하여 프롬프트 검색 및 실행
create --name <name> [--content text] [--global] 새 프롬프트를 생성합니다. 제공된 콘텐츠가 없는 경우 편집기를 엽니다.
edit <name> [--global] 기본 편집기에서 기존 프롬프트 편집
remove <name> [--global] 기존 프롬프트 제거(확인 필요)

채팅에서 프롬프트 사용

프롬프트는 @ 접두사를 사용하여 채팅에서 직접 호출할 수 있습니다.

@<prompt-name> [arguments...]

예시:

# Simple prompt without arguments
@code-review

# Prompt with single argument
@debug-help "connection timeout error"

# Prompt with multiple arguments
@aws-deploy "my-service" "production" "us-west-2"

# Server-specific prompt (when ambiguous)
@dev-tools/analyze "performance issue"

프롬프트 인수

프롬프트는 인수를 수락하여 동작을 사용자 지정할 수 있습니다.

  • 필수 인수: 다음과 같이 제공해야 합니다. <arg>

  • 선택적 인수: 생략할 수 있으며 로 표시됨 [arg]

  • 따옴표로 묶인 인수: 공백이 포함된 인수에 따옴표 사용

/prompts details <name>를 사용하여 프롬프트가 수락하는 인수를 검색합니다.

q diagnostic

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

구문: 

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

q issue

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

구문: 

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

q version

버전 정보를 표시하고 필요에 따라 변경 로그를 표시합니다.

구문: 

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

q mcp

Model Context Protocol(MCP) 서버를 관리합니다. MCP에 대한 자세한 내용은 Amazon Q Developer와 함께 MCP 사용 섹션을 참조하세요.

구문: 

q mcp [SUBCOMMAND] [OPTIONS]

q mcp add

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

구문: 

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

q mcp remove

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

구문: 

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

q mcp list

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

구문: 

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

q mcp import

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

구문: 

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

q mcp status

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

구문: 

q mcp status [OPTIONS]
q mcp status 인수
인수 Description
--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