---
title: IP 허용 목록
url: https://platform.claude.com/docs/ko/manage-claude/ip-allowlist
description: 신뢰할 수 있는 특정 IP 주소로 접근을 제한하여 조직을 보호하세요.
featureMetadata:
status: beta
---
“IP allowlisting”(IP 허용 목록)은 [적용 대상 요청](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#where-the-allowlist-applies)을 특정 IP 범위에서만 허용하여 조직을 보호합니다. 즉, API 키가 유출되더라도 공격자가 해당 키를 사용하기가 훨씬 어려워집니다. 이를 통해 데이터 유출을 방지하고 악용으로 인한 요금 부과 가능성을 줄일 수 있습니다.
허용 목록은 키가 작동하는 위치를 제한할 뿐, 작동 기간을 제한하지는 않습니다. 짧은 [키 만료](https://platform.claude.com/docs/ko/manage-claude/authentication#key-expiration)도 함께 설정하거나, 정적 키 사용을 중단하려면 [Workload Identity Federation](https://platform.claude.com/docs/ko/manage-claude/workload-identity-federation)으로 전환하는 것이 좋습니다. 이 방법이 허용 목록만 사용하는 것보다 더 안전합니다.
IP 허용 목록은 [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) 및 [Service Specific Terms](https://www.anthropic.com/legal/service-specific-terms) 등 고객과 Anthropic 간의 계약에 따라 베타로 제공됩니다. 베타 기간 동안 설정과 동작이 변경될 수 있습니다.
## 작동 방식
조직 관리자 또는 소유자가 설정에서 IP 범위 목록을 구성합니다. 이 범위 목록은 조직 전체에 적용됩니다. 적용 대상 요청마다 Anthropic은 요청의 공개 IP 주소를 목록과 비교하고, 허용되지 않은 경우 요청을 거부합니다.
* 목록 외부의 주소에서 [적용 대상 엔드포인트](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#where-the-allowlist-applies)로 보낸 **API 요청**은 거부됩니다. 예를 들어 Messages API는 `Your IP address isn't in this organization's allowed range.` 메시지와 함께 403 `permission_error`를 반환합니다.
* 허용되지 않은 주소에서 접속하는 **사용자**는 **Your current network can’t access this organization**이라는 제목의 페이지를 보게 됩니다. 조직 관리자도 차단되지만, 접근 차단을 방지하기 위해 선택적으로 [관리자에게 복구 경로를 제공](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#avoid-locking-yourself-out)할 수 있으며, 이 경우 관리자는 허용 목록 설정에만 접근할 수 있습니다.
## Claude Platform 조직
### 허용 목록이 적용되는 범위
* **Claude Console:** UI 접근이 제한됩니다.
* **다음 Claude API 엔드포인트:** API 키 또는 Workload Identity Federation 토큰을 사용하는 [Messages](https://platform.claude.com/docs/ko/api/messages), [Message Batches](https://platform.claude.com/docs/ko/build-with-claude/batch-processing), [Token Counting](https://platform.claude.com/docs/ko/build-with-claude/token-counting), [Models](https://platform.claude.com/docs/ko/api/models/list), [Files](https://platform.claude.com/docs/ko/build-with-claude/files), [Skills](https://platform.claude.com/docs/ko/build-with-claude/skills-guide).
* **다음 Claude Managed Agents 엔드포인트:** API 키 또는 Workload Identity Federation 토큰을 사용하는 [Agents](https://platform.claude.com/docs/ko/managed-agents/agent-setup), [Sessions](https://platform.claude.com/docs/ko/managed-agents/sessions), [Environments](https://platform.claude.com/docs/ko/managed-agents/environments), [Vaults](https://platform.claude.com/docs/ko/managed-agents/vaults), [Memory stores](https://platform.claude.com/docs/ko/managed-agents/memory).
* **다음 조직 API:** [이 조직에만 적용되는 키](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys#which-key-do-you-need)를 사용하는 [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api)와 [Compliance API](https://platform.claude.com/docs/ko/manage-claude/compliance-api).
[제한 사항](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#limitations)도 참조하세요.
## Claude Enterprise 조직
Claude Enterprise 조직에는 자체 IP 허용 목록이 있어, 특정 IP 범위에서만 [적용 대상 앱](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#apps-that-the-allowlist-covers)에 접근할 수 있도록 허용합니다. 즉, 사용자의 로그인 정보가 도용되더라도 공격자가 이를 사용하기가 훨씬 어려워집니다. 이 목록은 소유자를 포함한 조직 전체에 적용됩니다. 소유자와 기본 소유자가 이를 설정할 수 있습니다. [허용 목록을 켜기](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#turn-on-the-allowlist) 전에 [접근 차단 방지](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#avoid-locking-yourself-out)를 읽어 보세요.
### 허용 목록이 적용되는 앱
목록 외부의 사용자는 다음에서 조직에 대한 접근 권한을 잃게 됩니다:
* 브라우저의 Claude, 데스크톱 앱, 모바일 앱
* 사용자가 Claude 계정으로 로그인한 경우의 [Claude Code](https://code.claude.com/docs/ko/overview)
* Claude in Chrome, [Office 추가 기능](https://claude.com/docs/office-agents/overview), [Cowork](https://claude.com/docs/cowork/overview), Remote Tools
여기에는 이러한 앱의 커넥터와 Artifacts가 포함되며, 사용자가 조직 외부에 공유한 Artifacts는 제외됩니다. Claude Science의 경우 [Claude Science 관리자 제어의 Identity and access](https://claude.com/docs/claude-science/admin-controls#identity-and-access)를 참조하세요.
허용 목록은 [이 조직에만 적용되는 키](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys#which-key-do-you-need)를 사용하는 [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api)와 [Compliance API](https://platform.claude.com/docs/ko/manage-claude/compliance-api)에도 적용됩니다.
[제한 사항](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#limitations)도 참조하세요.
### 사용자에게 예상되는 사항
웹과 데스크톱 앱에서 차단된 사용자는 **Your current network can’t access this organization**이라는 제목의 페이지를 보게 됩니다. 소유자도 차단되지만, 접근 차단을 방지하기 위해 선택적으로 [소유자에게 복구 경로를 제공](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#avoid-locking-yourself-out)할 수 있으며, 이 경우 소유자는 허용 목록 설정에만 접근할 수 있습니다. Claude Code에서는 차단된 사용자에게 `Your IP address isn't in this organization's allowed range.` 메시지와 함께 403 API 오류가 표시됩니다.
* **다른 계정:** 차단된 사용자도 여전히 로그인하여 다른 조직이나 개인 계정을 사용할 수 있습니다.
* **원격 사용자:** 모바일 데이터를 사용하는 휴대폰, 가정용 Wi-Fi, VPN에 연결되지 않은 노트북은 목록에 있는 네트워크를 통해 연결하기 전까지 차단됩니다.
* **프록시:** 일부 기능은 `bridge.claudeusercontent.com`을 통해 연결됩니다: Claude in Chrome, Cowork, Remote Tools, 그리고 Office 추가 기능의 [앱 간 작업](https://claude.com/docs/office-agents/work-across-apps). 프록시가 이 호스트로의 트래픽을 `claude.ai` 및 `api.anthropic.com`과 다른 주소로 내보내는 경우, 해당 주소도 목록에 추가하세요.
## 제한 사항
* **Claude Platform:** 허용 목록은 [Claude Managed Agents](https://platform.claude.com/docs/ko/managed-agents/overview) 엔드포인트에 대한 요청에 적용되며, 에이전트 자체에는 적용되지 않습니다. Claude Managed Agents 런타임의 어떤 네트워킹에도 적용되지 않습니다. 허용 목록은 [Claude in Amazon Bedrock](https://platform.claude.com/docs/ko/build-with-claude/claude-in-amazon-bedrock), [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud](https://platform.claude.com/docs/ko/build-with-claude/claude-models-on-google-cloud/overview) 또는 [Claude in Microsoft Foundry](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry)에는 적용되지 않습니다.
* **Claude Enterprise:** Claude Design, Claude in Slack, Claude Academy는 적용 대상이 아닙니다. 사용자가 차단될 때 Claude가 채팅에서 작업을 수행 중이었다면, 해당 작업은 최대 24시간 동안 계속될 수 있습니다. 사용자는 목록 외부에서 해당 채팅을 열거나 제어할 수 없습니다.
## 허용 목록 켜기
조직의 설정 페이지로 이동하세요:
* **Claude Platform:** Claude Console의 [Identity and access](https://platform.claude.com/settings/identity) 페이지
* **Claude Enterprise:** [claude.ai > Organization settings > Organization and access](https://claude.ai/admin-settings/organization#ip-allowlist)
**IP allowlist** 토글을 켜세요. 저장하기 전까지는 아무것도 변경되지 않습니다.
**Add entry**(Claude Console) 또는 **Add IP range**(claude.ai)를 클릭하고 하나 이상의 주소 또는 범위를 쉼표로 구분하여 입력한 다음 Enter 키를 누르세요. 현재 접속 중인 네트워크를 포함하여 서버, CI, 사용자가 접속하는 각 네트워크를 나열하세요. Anthropic은 [접근 차단을 방지](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#avoid-locking-yourself-out)하기 위해 **Allow admins to access this settings page from any IP address**(Claude Console) 또는 **Allow owners to access this settings page from any IP address**(claude.ai) 체크박스가 선택되어 있는지 확인할 것을 권장합니다. 그런 다음 **Save**를 클릭하고 확인하세요.
변경 사항이 적용되기까지 최대 15분이 걸릴 수 있습니다. 매일 또는 매주만 실행되는 작업을 포함하여 애플리케이션에서 403 `permission_error` 응답이 발생하는지 지켜보고, 누락된 주소가 있으면 추가하세요. Claude Enterprise 조직에서는 각 네트워크의 사용자에게 여전히 Claude를 열 수 있는지 확인해 달라고 요청하세요. 이러한 조직에서는 이미 열려 있는 연결, Office 추가 기능, Remote Tools에 변경 사항이 반영되기까지 더 오래 걸릴 수 있습니다.
### 항목 형식
* **형식:** IPv4 또는 IPv6 주소를 허용 목록에 추가할 수 있습니다. 각 항목은 단일 주소(`203.0.113.5`) 또는 CIDR 범위(`203.0.113.0/24`, `2001:db8::/32`)일 수 있으며, 범위는 IPv4의 경우 `/8`, IPv6의 경우 `/32`보다 넓을 수 없습니다. 목록에는 최대 1,000개의 항목을 담을 수 있습니다.
* **공개 주소만 사용:** `10.0.0.0/8`과 같은 사설 범위가 아니라, 트래픽이 네트워크에서 나가는 주소를 나열하세요. 공유 프록시 주소를 추가하는 경우, 유출된 키나 도용된 로그인 정보를 가진 공격자가 해당 프록시를 통해 이를 사용할 수 있다는 점에 유의하세요.
## 접근 차단 방지
저장할 때 설정 페이지는 사용자가 자신의 접근을 차단하지 않도록 현재 주소를 목록과 대조하여 확인합니다. 하지만 서버, 팀원 또는 내일 접속할 수도 있는 주소는 확인하지 않습니다.
* **모든 네트워크를 먼저 나열하세요:** 데이터 센터, CI 시스템, 사무실, VPN, 프록시, 그리고 모든 [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes)의 워커를 공개 IPv4 및 IPv6 주소와 함께 포함하세요. 가정용 및 모바일 주소는 예고 없이 자주 변경될 수 있다는 점에 유의하세요.
* **복구 경로를 유지하세요:** Anthropic은 **Allow admins to access this settings page from any IP address**(Claude Console) 또는 **Allow owners to access this settings page from any IP address**(claude.ai) 체크박스를 선택할 것을 권장합니다. 그러면 관리자(claude.ai에서는 소유자)가 어디서든 목록을 수정할 수 있습니다. 단점은 관리자나 소유자의 세션을 탈취한 공격자가 원격 위치에서 허용 목록을 변경할 수 있다는 것입니다. 조직에 [Compliance API를 설정](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access)한 경우 해당 [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed)가 허용 목록의 변경 사항을 기록하므로 이를 감사할 수 있습니다.
### 접근이 차단된 경우
Claude Enterprise 조직에서는 관리자가 목록을 변경할 수 없으므로, 아래 단계에서 "관리자나 소유자"는 소유자 또는 기본 소유자를 의미합니다.
1. **목록에 있는 네트워크에서 다시 접속하세요:** 사무실 네트워크나 VPN에 연결한 다음 **Try again**을 클릭하세요. **Try again** 버튼이 없으면 페이지를 새로고침하세요.
2. **다른 관리자나 소유자에게 요청하세요:** 목록에 있는 네트워크의 관리자나 소유자가 주소를 추가할 수 있습니다.
3. **현재 위치에서 목록을 수정하세요:** 관리자나 소유자이고 [복구 경로를 유지하세요](https://platform.claude.com/docs/ko/manage-claude/ip-allowlist#avoid-locking-yourself-out)의 체크박스가 선택되어 있다면, 브라우저에서 Claude Console 또는 Claude를 열고 **Open IP allowlist**를 클릭하거나 [Identity and access](https://platform.claude.com/settings/identity) 페이지(claude.ai에서는 [Organization and access](https://claude.ai/admin-settings/organization#ip-allowlist))로 이동하세요. **Add it**을 클릭하여 현재 주소를 추가하거나 허용 목록을 끈 다음, **Save**를 클릭하고 확인하세요. 접근이 복구되기까지 최대 15분이 걸릴 수 있습니다.
4. **Anthropic에 문의하세요:** 어떤 관리자나 소유자도 페이지에 접근할 수 없다면 [Anthropic 지원팀](https://support.claude.com)에 허용 목록을 꺼 달라고 요청하세요.