바이브 코딩 →

네트워크 액세스Network Access

네트워크 액세스(Network Access)는 외출 허락 범위 같은 것 — 클라우드 환경에서 AI 에이전트가 인터넷의 어느 사이트까지 접속할 수 있는지 정하는 설정이에요.

네트워크 액세스는 아이에게 주는 외출 허락 범위와 비슷해요. '집 안에서만', '동네 놀이터와 학교까지만', '어디든 괜찮아'처럼 범위를 정해 두듯, 클라우드에서 일하는 AI 에이전트에게도 인터넷의 어디까지 나갈 수 있는지 정해 줘요. 범위가 좁으면 안전하지만 할 수 있는 일이 줄고, 넓으면 편하지만 위험도 커져요.

강의에서는 Claude Code를 클라우드 환경에서 쓰기 위해 새 환경을 만들 때 이 설정을 골라요. 선택지는 신뢰된 곳만 허용하는 방식, 사용자 정의(예: *.naver.com처럼 허용할 도메인을 직접 적는 방식), 전체 허용이 있어요. 한 강의에서는 처음엔 좁게 시작해 필요한 도메인만 늘려 가라고 권하고, 다른 강의에서는 영상 편집 자동화처럼 여러 외부 서비스에 접속해야 하는 작업을 위해 '전체'를 고르고 시크릿 키와 환경 변수를 넣어 환경을 추가해요. 결국 답은 '무슨 일을 시킬지'에 따라 달라져요.

초보가 자주 겪는 문제는 범위를 좁게 해 놓고 에이전트가 패키지 설치나 API 호출에 실패하는 경우예요. 오류에 '연결 거부'나 '차단' 같은 말이 보이면 네트워크 액세스 설정부터 확인하세요. 반대로 전체 허용을 켰다면, 시크릿 키 같은 민감 정보를 넣을 때 더 신중해야 해요. 필요한 범위만 열어 두는 최소 권한 원칙을 떠올리면 판단하기 쉬워요.

💡 대표 예시

  • 환경 생성 — 클라우드 환경을 만들며 네트워크 액세스 범위를 고른다
  • 허용 도메인 — 사용자 정의에 *.naver.com처럼 필요한 주소만 적는다
  • 영상 자동화 — 외부 서비스가 많은 작업이라 전체 허용으로 환경을 만든다
  • 오류 해결 — 패키지 설치가 막히면 네트워크 액세스 범위를 먼저 본다
  • 보안 점검 — 전체 허용 환경에 넣은 시크릿 키 목록을 다시 확인한다

🔗 관련 용어

허용 목록

허용 목록(Allowlist)은 출입 명단에 이름이 있는 사람만 들여보내는 경비실 같은 것 — 미리 등록한 사용자·주소·기능만 접근을 허락하고 나머지는 모두 막는 보안 설정이에요.

클로드 코드

클로드 코드(Claude Code)는 내 컴퓨터에 들어와 일하는 AI 개발자 같은 것 — Anthropic이 만든 AI 코딩 도구로, 말로 지시하면 파일을 읽고 코드를 고치고 명령어를 실행해 작업을 끝까지 진행해요.

클라우드 세션

클라우드 세션(Cloud session)은 늘 켜져 있는 공유 사무실 컴퓨터에서 일하는 것 같은 것 — AI 코딩 도구의 작업을 내 PC가 아닌 클라우드 서버에서 실행해, PC를 꺼도 휴대폰 등에서 이어 쓸 수 있게 하는 방식이에요.

최소 권한 원칙

최소 권한 원칙(Principle of Least Privilege)은 아르바이트생에게 필요한 열쇠만 주는 것 같은 것 — 사람이나 AI 에이전트에게 일에 꼭 필요한 만큼의 권한만 주는 보안 원칙이에요.

샌드박스

샌드박스 (Sandbox)는 아이들 모래 놀이터 같은 것 — 모래를 아무리 흩뿌려도 놀이터 밖은 더럽혀지지 않듯, 에이전트 (Agent)가 실험적으로 코드를 실행해도 내 컴퓨터 실제 환경에는 전혀 영향을 주지 않는 격리된 공간이다.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.