네트워크 액세스(Network Access)는 외출 허락 범위 같은 것 — 클라우드 환경에서 AI 에이전트가 인터넷의 어느 사이트까지 접속할 수 있는지 정하는 설정이에요.
네트워크 액세스는 아이에게 주는 외출 허락 범위와 비슷해요. '집 안에서만', '동네 놀이터와 학교까지만', '어디든 괜찮아'처럼 범위를 정해 두듯, 클라우드에서 일하는 AI 에이전트에게도 인터넷의 어디까지 나갈 수 있는지 정해 줘요. 범위가 좁으면 안전하지만 할 수 있는 일이 줄고, 넓으면 편하지만 위험도 커져요.
강의에서는 Claude Code를 클라우드 환경에서 쓰기 위해 새 환경을 만들 때 이 설정을 골라요. 선택지는 신뢰된 곳만 허용하는 방식, 사용자 정의(예: *.naver.com처럼 허용할 도메인을 직접 적는 방식), 전체 허용이 있어요. 한 강의에서는 처음엔 좁게 시작해 필요한 도메인만 늘려 가라고 권하고, 다른 강의에서는 영상 편집 자동화처럼 여러 외부 서비스에 접속해야 하는 작업을 위해 '전체'를 고르고 시크릿 키와 환경 변수를 넣어 환경을 추가해요. 결국 답은 '무슨 일을 시킬지'에 따라 달라져요.
초보가 자주 겪는 문제는 범위를 좁게 해 놓고 에이전트가 패키지 설치나 API 호출에 실패하는 경우예요. 오류에 '연결 거부'나 '차단' 같은 말이 보이면 네트워크 액세스 설정부터 확인하세요. 반대로 전체 허용을 켰다면, 시크릿 키 같은 민감 정보를 넣을 때 더 신중해야 해요. 필요한 범위만 열어 두는 최소 권한 원칙을 떠올리면 판단하기 쉬워요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.