Amazon Q 설정 구성 - Amazon Q Developer

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

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 및 서비스 설정

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"

모델 컨텍스트 프로토콜 설정

MCP 설정
키 설정 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

설정 파일 문제

설정 파일이 손상된 경우:

  1. 현재 설정 백업: q settings list --format json > backup.json

  2. 설정 파일을 엽니다. q settings open

  3. JSON 구문 확인 또는 백업에서 복원

기타 Amazon Q CLI 명령

Amazon Q는 설정 관리 외에도 다른 많은 명령줄 기능을 제공합니다. 사용 가능한 모든 명령과 관련 인수에 대한 포괄적인 참조는 Amazon Q CLI 명령 참조 섹션을 참조하세요.

명령에 도움이 필요하면 --help 플래그를 사용하세요.

q [COMMAND] --help