Qt AI Assistant 사용하기

Qt AI Assistant는 코딩 도우미입니다. LLM(대규모 언어 모델)에 연결하면 코드를 자동 완성하고, 전문가 코딩 조언을 제공하고, 코드 수정을 제안하고, 테스트 케이스와 코드 문서를 작성합니다.

Qt AI Assistant는 일부 상용 Qt 개발자 라이선스 보유자에게만 제공됩니다. 라이선스에 대한 자세한 내용은 Qt 가격에서 Compare 을 참조하세요.

Qt AI Assistant의 기초를 배우려면 Qt Academy를 수강하세요: Qt AI Assistant 시작하기 강좌를 수강하세요.

Qt AI Assistant는 현재 실험 단계이며 제너레이티브 AI로 구동됩니다. 모든 제안을 확인하여 프로젝트에 사용하기에 적합한지 확인하세요.

Qt AI Assistant 설치하기

웹에서 Qt AI Assistant 확장 프로그램을 로드하려면 다음과 같이 하세요:

1. Extensions 로 이동합니다.

   

2. Use external repository 을 선택합니다.
3. AI Assistant 을 선택합니다.
4. Install 을 선택합니다.

인라인 채팅 창에서 코드 구문 강조 표시 활성화하기

인라인 채팅 창에서 코드 구문 강조 표시를 사용 설정하려면 환경설정 > Text Editor > Generic Highlighter 으로 이동한 다음 Download Definitions 을 선택합니다.

자세한 내용은 하이라이트 정의 다운로드를 참조하세요.

Ollama 설치 및 사용

컴퓨터에서 로컬로 실행되는 LLM을 Qt AI Assistant 확장 프로그램과 함께 사용하려면 Ollama를 설치하세요. Ollama 선택 항목에서 사용 가능한 모델과 Ollama에 추가하는 사용자 지정 모델을 실행할 수 있습니다.

올라마에서 모델 실행하기

모델을 실행하려면 다음을 입력합니다:

ollama run <model-name>

예를 들어 다음과 같이 입력합니다:

ollama run codellama:7b-code

Ollama에서 지원되는 모델

Ollama에서 바로 다음 모델을 사용할 수 있습니다:

• codellama:7b-code
• deepseek-coder-v2:lite
• gpt-oss:20b
• theqtcompany/codellama-7b-qml
• theqtcompany/codellama-13b-qml

사용자 지정 모델

사용자 지정 모델의 경우 해당 모드에 대한 특정 설치 지침을 따르세요. 다음 사용자 지정 모델을 사용할 수 있습니다:

• codellama:7b-code-QML
• codellama:13b-code-QML

LLM에 연결

다음 LLM에 연결할 수 있습니다:

• Code Llama 13B QML(선택한 클라우드 배포에서 실행되는 Qt 6용)
• Code Llama 13B(Qt 5용, 선택한 클라우드 배포에서 실행)
• Codestral(Mistral 제공)
• Claude 4.0 Sonnet(Anthropic에서 제공, Anthropic 계정에 토큰 기반 결제 수단이 구성되어 있어야 함: console.anthropic.com)
• Claude 4.5 Sonnet(Anthropic에서 제공, Anthropic 계정에 토큰 기반 청구 결제 수단이 구성되어 있어야 함을 기억하세요: console.anthropic.com).
• GPT 5(OpenAI에서 제공, OpenAI 계정에 토큰 기반 청구 결제 수단이 구성되어 있어야 함을 기억하세요: platform.openai.com)
• DeepSeek V3.2(DeepSeek 제공)
• Ollama를 통한 Code Llama 13B QML(컴퓨터에서 로컬로 실행)
• Ollama를 통한 Code Llama 7B QML(컴퓨터에서 로컬로 실행)
• Ollama를 통한 Code Llama 7B(컴퓨터에서 로컬로 실행)

LLM에 연결하려면 다음과 같이 하세요:

1. 환경설정 > AI Assistant > General 으로 이동합니다.

   

2. 구성 가능한 각 사용 사례에 대해 LLM을 선택합니다.
3. Advanced 으로 이동합니다.

   

4. 각 LLM의 API 인증 토큰과 서버 URL을 입력합니다. 액세스 정보를 얻을 수 있는 위치에 대한 자세한 내용은 타사 LLM 제공업체 설명서를 참조하세요.

자동 코드 완성

Qt AI Assistant는 다음에 작성할 내용을 제안하여 코드 작성을 도와줍니다. 입력을 중단하면 LLM이 하나의 코드를 제안하는 메시지를 표시합니다.

전체 제안을 수락하려면 Tab 키를 선택합니다.

제안의 일부를 수락하려면 Alt+Right를 선택합니다.

제안을 취소하려면 Esc 키를 선택하거나 코드 편집기에서 다른 위치로 이동합니다.

마우스를 사용하여 Qt AI Assistant와 상호 작용하려면 제안 사항 위로 마우스를 가져갑니다.

제안 사항 위로 마우스를 가져가면 제안된 코드 조각의 일부를 단어 단위 또는 줄 단위로 수락할 수 있습니다.

코드 완성 표시줄을 닫으려면 Esc 키를 선택하거나 커서를 다른 위치로 이동합니다.

코드 완성 모델을 선택하려면 환경설정 > AI Assistant > General 으로 이동하세요.

General 에서 모든 프로젝트에 대해 코드 자동 완성 기능을 전역적으로 켜거나 끌 수도 있습니다. Qt AI Assistant는 LLM에서 상당한 수의 토큰을 소비합니다. 비용을 절감하려면 필요하지 않을 때는 자동 완성 기능을 끄고 키보드 단축키를 사용하여 코드를 완성하세요.

키보드에서 코드 완성하기

코드 제안을 수동으로 트리거하려면 Ctrl+'을 선택합니다.

프롬프트 및 스마트 명령 입력

텍스트 편집기의 인라인 프롬프트 창에서 어시스턴트에게 인간 언어로 요청을 구현하거나 질문을 하거나 스마트 명령을 실행하도록 프롬프트를 입력할 수 있습니다. 채팅을 열려면 Ctrl+Shift+A를 선택합니다. 또는 인라인 프롬프트 창을 열려면 코드를 선택한 다음 을 선택할 수 있습니다.

인라인 프롬프트 창을 닫으려면 Esc 또는 을 선택합니다.

인라인 프롬프트 창에서 Qt AI Assistant 환경 설정으로 이동하려면 을 선택합니다. 여기에서 프롬프트 및 코드 검토에 사용할 모델을 설정할 수 있습니다.

인간 언어를 사용하여 제안 요청하기

사람의 언어를 사용하여 제안을 요청하려면 입력 필드에 요청을 입력합니다. 강조 표시된 코드가 있는 경우 AI 어시스턴트가 프롬프트에 컨텍스트로 추가합니다. 인라인 프롬프트 창에서 Copy 을 선택하여 클립보드에 복사할 수 있는 제안을 Qt AI Assistant에 표시합니다.

코드 검토 요청하기

Qt AI Assistant로 코드를 검토하려면 다음과 같이 하세요:

1. 코드 에디터에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /review 스마트 명령을 선택합니다.

Qt AI Assistant가 코드를 검토하고 개선 사항을 제안합니다. 환경설정 > AI Assistant > General 에서 Enable QML linter 이 켜져 있는 경우 QML Lint를 사용하여 QML 코드를 검토합니다.

Qt Test 구문으로 테스트 케이스 요청하기

Qt AI Assistant로 테스트 케이스를 작성하려면:

1. 코드 에디터에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /qtest 스마트 명령을 선택합니다.

Qt AI Assistant가 테스트 케이스를 생성합니다. Qt Test 형식으로 테스트 케이스를 생성하여 Qt 테스트 프로젝트에 복사하여 붙여넣을 수 있습니다.

생성된 테스트 케이스를 실행하려면 Qt Test 사례를 실행하려면 CMakeLists.txt 파일과 main.cpp 파일을 구성합니다.

메인 프로젝트 구성하기 CMakeLists.txt

1. 모듈을 라이브러리 및 QML 모듈로 정의합니다. URI 값에 따라 TestCase 스크립트에서 사용되는 가져오기 이름이 결정됩니다:

   qt_add_library({module_name} STATIC)
   qt_add_qml_module({module_name}
       URI {module_name}
       VERSION 1.0
       QML_FILES
               Main.qml
   )

2. 자동 생성된 플러그인을 대상의 링크 라이브러리에 추가합니다. 플러그인 이름은 <모듈_이름>플러그인 패턴을 따릅니다:

   target_link_libraries({project}
       PRIVATE Qt6::Quick {module_nameplugin}
   )

3. 파일 끝에 QML_IMPORT_PATH 을 추가하여 QML 엔진이 모듈을 찾을 수 있도록 합니다:

   set(QML_IMPORT_PATH ${CMAKE_BINARY_DIR} CACHE STRING "" FORCE)

테스트 프로젝트 구성 CMakeLists.txt

플러그인을 테스트 대상(test_directory)에 연결합니다:

target_link_libraries({test_directory} PRIVATE Qt${QT_VERSION_MAJOR}::QuickTest {module_nameplugin})

메인 프로젝트 구성 main.cpp

등록된 모듈에서 QML 컴포넌트를 로드하려면 loadFromModule() 을 사용합니다:

engine.loadFromModule("{module_name}", "Main");

외부 테스트 프로젝트 구성

테스트 프로젝트가 메인 프로젝트 외부에 있는 경우:

1. 테스트 프로젝트에 메인 프로젝트를 하위 디렉터리로 추가합니다 CMakeLists.txt:

   add_subdirectory(../{main_project_directory} ${CMAKE_BINARY_DIR}/{main_project_directory})

2. Qt가 모듈을 찾을 수 있도록 QML 가져오기 경로를 설정합니다:

   set_target_properties({test_directory} PROPERTIES
       QT_QML_IMPORT_PATH "${CMAKE_BINARY_DIR}/{main_project_directory}"
   )

프로젝트를 다시 빌드합니다.

마크다운 형식의 코드 문서 요청하기

코드 문서를 생성하려면:

1. 코드 에디터에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /doc 스마트 명령을 선택합니다.

Qt AI Assistant가 문서 파일에 복사하여 붙여넣을 수 있는 형식으로 코드 문서를 생성합니다.

코드 수정 요청하기

코드 수정을 요청하려면 다음과 같이 하세요:

1. 코드 편집기에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /fix 스마트 명령을 선택합니다.
4. 원하는 경우 변경 사항을 코드에 적용합니다.

Qt AI Assistant가 코드에 적용할 수 있는 수정 사항을 제안합니다.

코드 설명 요청하기

기존 코드에 대한 설명을 요청하려면 다음과 같이 하세요:

1. 코드 편집기에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /explain 스마트 명령을 선택합니다.

Qt AI Assistant가 강조 표시된 코드에 대한 설명을 제공합니다.

인라인 주석 추가하기

Qt AI Assistant로 기존 코드에 인라인 주석을 추가하려면 다음과 같이 하세요:

1. 코드 에디터에서 코드를 강조 표시합니다.
2. 인라인 프롬프트 창을 엽니다.
3. /inlinecomments 스마트 명령을 선택합니다.
4. 원하는 경우 코드에 주석을 적용합니다.

Qt AI Assistant가 코드에 적용할 수 있는 인라인 코멘트를 추가합니다.