기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Q 설정 구성
Amazon Q는 설정을 통해 동작을 사용자 지정하는 다양한 방법을 제공합니다. 그래픽 인터페이스와 명령줄 옵션을 통해 이러한 설정에 액세스할 수 있습니다.
액세스 설정
다음 두 가지 방법으로 Amazon Q 설정에 액세스할 수 있습니다.
-
설정 GUI:
q settings를 실행하여 그래픽 설정 인터페이스 열기 -
명령줄: 다양한 명령을 사용하여 설정을 직접 보고 수정
명령줄에서 설정 관리
다음 명령을 사용하여 명령줄에서 직접 Amazon Q 설정을 관리할 수 있습니다.
| 명령 | Description |
|---|---|
q settings open |
기본 편집기에서 설정 파일 열기 |
q settings list |
구성된 모든 설정을 나열합니다. |
q settings list --all |
설명과 함께 사용 가능한 모든 설정을 나열합니다. |
q settings list --format json-pretty |
형식이 지정된 JSON으로 설정을 나열합니다. |
q settings [KEY] |
특정 설정의 값을 봅니다. |
q settings [KEY] [VALUE] |
특정 설정을 지정된 값으로 설정합니다. |
q settings --delete [KEY] |
특정 설정 삭제 |
q settings 명령을 사용할 때 다음과 같이 출력 형식을 지정할 수 있습니다.
q settings --format [FORMAT]
사용 가능한 형식:
-
plain: 결과를 일반 텍스트로 출력합니다(기본값). -
json: 결과를 JSON으로 출력 -
json-pretty: 결과를 형식이 지정된 JSON으로 출력
사용 가능한 설정 참조
다음 섹션에서는 범주별로 구성된 사용 가능한 모든 Amazon Q CLI 설정을 설명합니다. 각 설정에는 키 이름, 설명, 예상 값 유형 및 예제가 포함됩니다.
원격 측정 및 개인 정보 보호 설정
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
telemetry.enabled |
원격 측정 수집 활성화/비활성화 | boolean | q settings telemetry.enabled true |
telemetryClientId |
원격 측정을 위한 레거시 클라이언트 식별자 | 문자열 | q settings telemetryClientId "client-123" |
codeWhisperer.shareCodeWhispererContentWithAWS |
CodeWhisperer 서비스와 콘텐츠 공유 | boolean | q settings codeWhisperer.shareCodeWhispererContentWithAWS false |
채팅 인터페이스 설정
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
chat.enableThinking |
복잡한 추론을 위한 사고 도구 활성화 | boolean | q settings chat.enableThinking true |
chat.greeting.enabled |
채팅 시작 시 인사말 메시지 표시 | boolean | q settings chat.greeting.enabled false |
chat.editMode |
채팅 인터페이스에 대한 편집 모드 활성화 | boolean | q settings chat.editMode true |
chat.enableNotifications |
데스크톱 알림 활성화 | boolean | q settings chat.enableNotifications true |
chat.defaultModel |
대화를 위한 기본 AI 모델 | 문자열 | q settings chat.defaultModel "claude-3-sonnet" |
chat.disableMarkdownRendering |
채팅에서 마크다운 형식 비활성화 | boolean | q settings chat.disableMarkdownRendering false |
chat.defaultAgent |
기본 에이전트 구성 | 문자열 | q settings chat.defaultAgent "my-agent" |
chat.disableAutoCompaction |
자동 대화 요약 비활성화 | boolean | q settings chat.disableAutoCompaction true |
chat.enableHistoryHints |
대화 기록 힌트 표시 | boolean | q settings chat.enableHistoryHints true |
chat.uiMode |
사용할 UI 변형 지정 | 문자열 | q settings chat.uiMode "compact" |
chat.enableContextUsageIndicator |
프롬프트에 컨텍스트 사용률 표시 | boolean | q settings chat.enableContextUsageIndicator true |
지식 기반 설정
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
chat.enableKnowledge |
지식 기반 기능 활성화 | boolean | q settings chat.enableKnowledge true |
knowledge.defaultIncludePatterns |
지식 기반에 포함할 기본 파일 패턴 | array | q settings knowledge.defaultIncludePatterns '["*.py", "*.js"]' |
knowledge.defaultExcludePatterns |
지식 기반에서 제외할 기본 파일 패턴 | array | q settings knowledge.defaultExcludePatterns '["*.log", "node_modules"]' |
knowledge.maxFiles |
지식 인덱싱을 위한 최대 파일 수 | 숫자 | q settings knowledge.maxFiles 1000 |
knowledge.chunkSize |
지식 처리를 위한 텍스트 청크 크기 | 숫자 | q settings knowledge.chunkSize 512 |
knowledge.chunkOverlap |
텍스트 청크 간 중첩 | 숫자 | q settings knowledge.chunkOverlap 50 |
knowledge.indexType |
사용할 지식 인덱스 유형 | 문자열 | q settings knowledge.indexType "fast" |
키 바인딩
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
chat.skimCommandKey |
퍼지 검색 명령의 키 바인딩 | char | q settings chat.skimCommandKey "f" |
chat.autocompletionKey |
자동 완성 힌트 수락을 위한 키 바인딩 | char | q settings chat.autocompletionKey "Tab" |
chat.tangentModeKey |
접선 모드 토글의 키 바인딩 | char | q settings chat.tangentModeKey "t" |
chat.delegateModeKey |
위임 명령의 키 바인딩 | char | q settings chat.delegateModeKey "d" |
기능 토글
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
chat.enableTangentMode |
접선 모드 기능 활성화 | boolean | q settings chat.enableTangentMode true |
introspect.tangentMode |
내부 질문을 위한 접선 모드 자동 진입 | boolean | q settings introspect.tangentMode true |
chat.enableTodoList |
할 일 목록 기능 활성화 | boolean | q settings chat.enableTodoList true |
chat.enableCheckpoint |
체크포인트 기능 활성화 | boolean | q settings chat.enableCheckpoint true |
chat.enableDelegate |
하위 에이전트 관리를 위한 위임 도구 활성화 | boolean | q settings chat.enableDelegate true |
API 및 서비스 설정
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
api.timeout |
초 단위 API 요청 제한 시간 | 숫자 | q settings api.timeout 30 |
api.codewhisperer.service |
CodeWhisperer 서비스 엔드포인트 URL | 문자열 | q settings api.codewhisperer.service "https://codewhisperer.us-east-1.amazonaws.com" |
api.q.service |
Q 서비스 엔드포인트 URL | 문자열 | q settings api.q.service "https://q.us-east-1.amazonaws.com" |
모델 컨텍스트 프로토콜 설정
| 키 설정 | Description | 형식 | 예시 |
|---|---|---|---|
mcp.initTimeout |
MCP 서버 초기화 제한 시간 | 숫자 | q settings mcp.initTimeout 10 |
mcp.noInteractiveTimeout |
비대화형 MCP 제한 시간 | 숫자 | q settings mcp.noInteractiveTimeout 5 |
mcp.loadedBefore |
이전에 로드된 MCP 서버 추적 | boolean | q settings mcp.loadedBefore true |
일반 설정 예제
다음은 몇 가지 일반적인 구성 시나리오입니다.
기본 구성
# Enable telemetry q settings telemetry.enabled true # Set default chat model q settings chat.defaultModel "claude-3-sonnet" # Disable greeting message q settings chat.greeting.enabled false
지식 기반 구성
# Enable knowledge base q settings chat.enableKnowledge true # Set file patterns to include q settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]' # Set file patterns to exclude q settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]' # Set maximum files to index q settings knowledge.maxFiles 2000
기능 구성
# Enable experimental features q settings chat.enableThinking true q settings chat.enableTangentMode true q settings chat.enableTodoList true q settings chat.enableCheckpoint true # Configure key bindings q settings chat.tangentModeKey "t" q settings chat.delegateModeKey "d"
설정 보기 및 관리
# View all configured settings q settings list # View all available settings with descriptions q settings list --all # View specific setting q settings chat.defaultModel # Export settings as JSON q settings list --format json-pretty > my-settings.json # Delete a setting q settings --delete chat.defaultModel
설정 문제 해결
설정 작업 시 일반적인 문제 및 해결 방법:
잘못된 설정 값
값을 설정할 때 오류가 발생하는 경우:
-
부울 값:
true또는 사용false(소문자) -
배열 값: 작은따옴표와 함께 JSON 형식 사용:
'["item1", "item2"]' -
문자열 값: 공백이 있는 문자열에 따옴표 사용:
"my value"
설정 재설정
설정을 기본값으로 재설정하려면:
# Delete individual settings q settings --delete setting.name # Open settings file for manual editing q settings open # View current settings to identify issues q settings list --all
설정 파일 문제
설정 파일이 손상된 경우:
-
현재 설정 백업:
q settings list --format json > backup.json -
설정 파일을 엽니다.
q settings open -
JSON 구문 확인 또는 백업에서 복원
기타 Amazon Q CLI 명령
Amazon Q는 설정 관리 외에도 다른 많은 명령줄 기능을 제공합니다. 사용 가능한 모든 명령과 관련 인수에 대한 포괄적인 참조는 Amazon Q CLI 명령 참조 섹션을 참조하세요.
명령에 도움이 필요하면 --help 플래그를 사용하세요.
q [COMMAND] --help