같은 명령이 로컬에서는 실행되지만 Agent에서는 문법 오류가 나는 경우 어떻게 하나요?
Agent가 실제 사용하는 셸을 먼저 확인한 뒤 매개변수, 따옴표, 경로를 수정하세요.
실행 진입점에 따라 다른 셸을 사용할 수 있습니다
운영체제나 직접 여는 터미널만으로 Agent의 셸을 판단하지 마세요. Windows에서는 데스크톱과 CLI 구현 모두 Git Bash를 우선 사용하고 없으면 cmd를 사용합니다. PowerShell로 고정되어 있지 않습니다. Unix 데스크톱은 호스트에서 사용 가능한 사용자의 셸을 선택하며 CLI는 일반 명령 경로에 bash를 사용합니다. 진입점이 달라지면 같은 문자열의 해석도 바뀔 수 있습니다.
경로와 따옴표 방식 먼저 확인하기
Agent가 실제 셸을 먼저 확인하게 한 뒤 공백이 포함된 경로, 물음표나 연결 기호가 있는 URL, 플랫폼별 매개변수 문법을 처리하세요. 일부 셸은 따옴표 없는 문자를 와일드카드로 해석하여 파일을 찾지 못한 것처럼 보이는 오류를 냅니다. 의심되는 문자 하나만 바꾸고 일괄 실행을 계속하지 마세요. 먼저 검증 가능한 단일 읽기 전용 명령으로 나눠 결과를 관찰할 수 있습니다.
문법 문제와 도구 부재 구분하기
‘프로그램을 찾을 수 없음’ 오류는 도구 설치와 경로를 먼저 확인하고 접근 거부는 시스템 권한을 확인하세요. 구문 분석 오류일 때 셸 문법 수정에 집중해야 합니다. 명령의 마지막 부분이 성공으로 보여도 앞선 오류 출력을 확인하여 부분 실패를 놓치지 마세요. 단일 단계의 동작이 올바른지 확인한 뒤 전체 작업을 복원하세요. 이를 위해 기본적으로 연결 토큰을 재설정하거나 클라이언트 권한을 높일 필요는 없습니다.