Vercel Agent, 비공개 npm 패키지 설치 지원…팀 공유 변수로 인증

이번 소식

Vercel이 AI 개발 도구 Vercel Agent의 비공개 패키지 설치 지원을 발표했습니다. npm이나 회사 전용 패키지 저장소에서 필요한 라이브러리를 가져올 수 있습니다. Agent 세션의 npm·pnpm·classic Yarn이 기존 Vercel 빌드와 같은 방식으로 인증합니다.

주요 변경

• 팀 공유 설정 사용: npm 공식 저장소의 비공개 패키지는 NPM_TOKEN, 사용자 지정 저장소나 여러 저장소는 NPM_RC로 구성합니다. 패키지를 읽을 수 있는 권한이 필요합니다.
• 적용 환경 구분: Agent는 팀의 공유 환경 변수 중 Development를 먼저 보고 Preview를 확인합니다. Production과 프로젝트에만 지정한 변수는 사용하지 않으며, 개별 프로젝트에 연결할 필요도 없습니다.
• 인증 값을 실행 공간 밖에 유지: 패키지 요청이 샌드박스를 나갈 때 인증합니다. 공식 문서는 인증 값이 샌드박스 밖에 있어 Agent와 그 안의 프로세스가 읽을 수 없다고 설명합니다.
• 빌드와 다른 인증 가능: Agent 전용 VERCEL_AGENT_NPM_RC 또는 VERCEL_AGENT_NPM_TOKEN을 지정하는 방법도 제공합니다.

영향 대상과 활용

예를 들어 회사 내부 UI 패키지가 필요한 저장소를 Agent에 맡길 때, 공개 패키지만으로는 작업 환경을 준비하기 어려울 수 있습니다. 이번 지원은 그런 의존성을 설치할 수 있게 하는 변경입니다. 회사 전용 라이브러리를 쓰는 개발팀에 직접적인 의미가 있습니다.

설치 명령 자체를 새로 배우기보다는, 어떤 팀 공유 설정을 Agent가 읽는지 확인하는 것이 중요합니다. 기존 빌드가 성공한다고 Agent 세션도 같은 설정을 읽는 것은 아니므로 프로젝트 전용 변수와 공유 변수를 구분해야 합니다.

사용 전 확인할 점

이번 인증은 패키지 다운로드에만 적용되며 패키지 발행이나 저장소 관리 작업을 지원하지 않습니다. 인증 값을 프롬프트나 명령에 직접 넣지 말라는 안내도 있습니다. 이 기사에서는 실제 인증 정보를 입력하거나 권한을 변경하지 않았습니다.

저장소 주소는 HTTPS와 DNS 호스트 이름을 사용해야 하고 사용자 지정 포트와 클라이언트 인증서는 지원하지 않습니다. 같은 환경에서는 NPM_RC가 NPM_TOKEN보다 우선합니다. 참조하는 토큰 변수도 같은 환경에 있어야 하므로 기존 설정의 이름·범위를 먼저 확인해야 합니다.

공식 출처·발표 시점

공식 피드 시각: 2026년 10월 1일 08:22 KST. 원문 표기일은 2026년 9월 30일입니다. 비공개 의존성 문서에서 적용 범위와 제약을 확인했습니다.

원문 출처 보기 →