Skip to main content

터미널 멘션

터미널 멘션을 사용하면 터미널 출력을 Cline과의 대화에 직접 가져올 수 있습니다. @terminal을 입력하기만 하면 Cline은 터미널의 최근 출력을 볼 수 있습니다.

채팅에 @를 입력하고 메뉴에서 "터미널"을 선택하거나 @terminal을 직접 입력합니다. Cline은 오류 메시지, 빌드 로그 또는 명령 결과를 포함하여 활성 터미널의 최근 출력을 즉시 볼 수 있습니다.

저는 빌드 오류, 테스트 실패 또는 디버깅 출력을 처리할 때 터미널 멘션을 항상 사용합니다. 터미널 출력을 복사하여 붙여넣으려고 애쓰는 대신(종종 서식이 손실됨) 다음과 같이 묻습니다.

테스트를 실행할 때 이 오류가 발생합니다: @terminal

무엇이 원인이고 어떻게 해결할 수 있나요?

이렇게 하면 모든 서식이 그대로 유지된 완전한 터미널 출력이 Cline에 제공됩니다. 그러면 Cline은 오류 메시지, 스택 추적 및 주변 컨텍스트를 분석하여 더 정확한 도움을 제공할 수 있습니다.

터미널 멘션은 파일 멘션과 결합될 때 특히 강력합니다. 실패한 API 호출을 디버깅할 때 종종 둘 다 참조합니다.

API를 호출할 때 이 오류가 발생합니다: @terminal

내 API 클라이언트 코드는 다음과 같습니다: @/src/api/client.js
그리고 엔드포인트 구현은 다음과 같습니다: @/src/server/routes/users.js

무엇이 잘못되었나요?

이 접근 방식은 정확한 오류 출력, 클라이언트 코드 및 서버 구현 등 필요한 모든 것을 수동으로 복사할 필요 없이 Cline에 제공합니다.

다음에 명령 출력 또는 빌드 오류와 관련된 문제가 발생할 때 출력을 복사하는 대신 @terminal을 사용해 보십시오. Cline이 적절한 서식과 함께 완전한 터미널 컨텍스트를 볼 수 있으므로 더 정확한 도움을 받을 수 있습니다.

내부 작동 방식

메시지에서 터미널 멘션을 사용하면 내부적으로 다음과 같은 일이 발생합니다.

  1. 메시지를 보내면 Cline은 텍스트에서 @terminal 패턴을 감지합니다.

  2. 확장은 VSCode의 터미널 API에 액세스하는 getLatestTerminalOutput()을 호출합니다.

  3. 활성 터미널에서 최근 출력 버퍼를 캡처합니다.

  4. 터미널 출력은 구조화된 형식으로 메시지에 추가됩니다.

    <terminal_output>
    $ npm run test
    > project@1.0.0 test
    > jest

    FAIL src/components/__tests__/Button.test.js
    ● Button component › renders correctly

    [서식이 유지된 전체 터미널 출력]
    </terminal_output>
  5. 포함된 터미널 출력이 있는 이 향상된 메시지가 AI로 전송됩니다.

  6. 이제 AI는 모든 서식이 유지된 완전한 터미널 출력을 "볼" 수 있습니다.

이 프로세스는 터미널 멘션을 사용할 때마다 자동으로 발생하여 수동으로 복사할 필요 없이 AI에 명령 결과, 오류 메시지 및 기타 터미널 출력에 대한 액세스를 제공합니다.

터미널 문제 해결

터미널 멘션 또는 일반적인 터미널 통합(예: "셸 통합 사용 불가" 또는 명령이 출력을 표시하지 않음)에 문제가 발생하는 경우 포괄적인 터미널 통합 문제 해결 가이드를 참조하십시오.

일반적인 문제는 다음과 같습니다.

  • 터미널 멘션이 출력을 캡처하지 못함
  • Caret 채팅에서 "셸 통합 사용 불가" 메시지
  • 명령은 실행되지만 Cline에 출력이 표시되지 않음
  • 터미널 통합이 일관되지 않게 작동함

문제 해결 가이드는 이러한 문제를 해결하기 위한 플랫폼별 솔루션 및 상세 구성 단계를 제공합니다.