Sur cette page8 sections
2026년 9월 자료를 기준으로 정리한 가이드입니다. 요금, 모델, 화면 명칭은 변경될 수 있으며 실시간 제품 정보가 아닙니다.
설치, 로그인, 모델, 확장 기능, MCP를 위한 실용적인 진단 절차.
설치 또는 실행 실패
공식 센터에서 운영체제와 아키텍처를 맞추고 재시도 전에 오류를 기록하세요. Linux는 배포판 형식에 맞는 패키지를 고르세요. macOS의 오래된 Intel 설치 파일이 현재도 지원된다고 가정하지 마세요.
로그인 또는 네트워크 오류
공식 웹사이트에 로그인되는지 확인하세요. 시각과 오류 코드를 기록하고 프록시, VPN, 조직 정책을 점검하세요. 계정과 로컬 문제를 구분하기 전에는 재설치를 반복하지 마세요.
모델 사용 불가 또는 토큰 한도 도달
요금제, 잔여량, 선택기를 확인하고 짧은 새 대화를 시험하세요. 소진된 한도는 재설치로 복구되지 않습니다. 추가 지출 전에 가격과 사용량 제어를 확인하세요.
MCP 서버가 시작되지 않음
JSON, 실행 파일 접근, 서버 로그를 확인하세요. npx가 작동하는 셸과 데스크톱 앱의 PATH가 다를 수 있습니다. MCP 가이드의 단계별 점검을 따르세요.
확장 기능 또는 인덱싱 문제
작은 프로젝트에서 의심되는 확장 기능을 잠시 꺼서 원인을 구분하세요. 공간 크기와 생성 파일 제외를 확인하세요. 초기화 전에 설정을 백업하고 지원팀에 보낼 최소 재현 사례를 준비하세요.
지원 요청에 포함할 내용
버전, 운영체제, 아키텍처, 지역, 요금제, 최소 재현, 민감 정보를 제거한 로그를 포함하세요. 공유 내용을 검토하지 않고 토큰, 환경 파일, 비공개 코드를 첨부하지 마세요.
첫 실제 작업: 수정, 검증, 검토
-
이미 빌드되는 작은 저장소를 선택하고 깨끗한 Git 체크포인트를 저장하세요. 현재 통과하는 검사 명령을 기록해 기준을 만듭니다.
-
기존 폼에 필수 입력을 추가하는 것처럼 확인 가능한 결과 하나를 지정하세요. 관련 파일, 기존 검증 함수, 유지할 동작을 알려 줍니다.
-
수정 전에 짧은 계획을 검토하세요. 영향받는 구성 요소, 데이터 흐름, 검증 명령을 확인하고 부족한 맥락을 먼저 보충합니다.
-
변경 사항을 나누어 검토하고 의존성, 생성 파일, 환경 변수와 오류 처리도 확인하세요. 정상 경로와 실패 경로를 모두 실행합니다.
-
완료 후 사용량과 검토 시간을 기록하세요. 두 번째 대표 작업에서도 시험한 뒤 유료 플랜이나 팀 이전을 결정합니다.
수정해서 사용할 작업 설명
목표: 사용자에게 보이는 변화.
맥락: 관련 파일과 기존 구현.
제약: 공개 API와 기존 의존성 유지.
검증: 프로젝트 검사와 실패 경로 확인.
완료: 변경 파일, 실행한 검사, 남은 제약 보고.결과를 사용할 수 없을 때
응답 성공이 올바른 코드를 보장하지는 않습니다. 잘못된 파일을 수정하면 범위를 좁히고 진입점을 알려 주세요. 명령 실패는 동일한 터미널 환경에서 재현하세요. MCP는 서버 시작, 인증, 클라이언트 설정을 분리해 확인하고 사용량 문제는 잔액과 모델부터 확인하세요. 관련 없는 작업을 잃지 않도록 패치를 작게 유지합니다.
이전 전 자주 묻는 질문
유료 구독이면 에이전트를 무제한으로 사용하나요?
아닙니다. 구독료, 포함 사용량, 모델 접근, 추가 사용료는 별개입니다. 무제한 자동완성이 무제한 모델 요청을 뜻하지는 않습니다.
모든 MCP 서버를 한꺼번에 연결하나요?
현재 작업에 필요한 하나부터 시작해 실행, 도구, 전달되는 맥락을 확인하고 차례로 추가하세요.
편집기를 공정하게 비교하려면?
같은 저장소, 작업, 합격 기준으로 올바른 변경, 검토 노력, 설정 부담, 실제 사용량을 비교하세요.
관련 TRAE 가이드
Continuer la lecture
Plus d’articles sur des thèmes et outils proches.
Outils cités
Explorer les fiches proches du sujet de cet article.


