HIPAA 조직용 Claude Code (local mode) 설정 (Set up Claude Code for a HIPAA-ready organization)

기준일: 2026-10-23
공식 기준: Set up Claude Code (local mode) for a HIPAA-ready organization

개요

HIPAA configuration은 Claude Enterprise 플랜의 조직 설정으로, 보호 대상 건강 정보(PHI)를 다루고 Anthropic과 Business Associate Agreement(BAA)를 맺은 조직을 위한 것입니다. Claude Code (local mode)와 Cowork (local mode)에 적용되며, 두 제품의 기능을 제한합니다.

"(local mode)"는 cloud 세션이 아닌 로컬 세션을 뜻합니다. 로컬 세션은 다음 중 하나에서 실행됩니다.

터미널의 Claude Code
Claude Desktop Code 탭의 Claude Code
Claude Desktop의 Cowork

VS Code·JetBrains용 Claude Code 확장은 (local mode)에 포함되지 않습니다. HIPAA configuration이 적용되어도 계속 동작하지만 BAA가 이를 보장하지 않습니다. Eligible Services 전체 목록은 Implementation Guide를 보세요.

이 페이지는 개발자 컴퓨터를 준비하는 IT·보안 관리자용입니다. configuration 적용 자체는 Claude 조직의 Primary Owner가 합니다. BAA에 무엇이 포함되는지, 적용 방법과 적용 날짜 예약은 Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan을 보세요. 조직에서 Cowork도 쓴다면 Claude Desktop 정책과 Cowork 로컬 데이터를 다루는 Set up Cowork (local mode) for a HIPAA-ready organization도 따르세요.

핵심 개념

시점	할 일
configuration 적용 전	컴퓨터 준비: 개발자 연결 방식 확인, 앱 업데이트, 네트워크 허용, managed settings 배포, Claude Desktop 로그인 제한
적용 후	Owner가 다시 켤 때까지 Code 탭이 꺼짐. 컴퓨터에서 configuration 확인
지속	로컬 세션 데이터 관리

항목	값
최소 버전	Claude Code v2.1.285 이상, Claude Desktop v2.19675.0 이상
적용 조건	Claude Enterprise 계정 로그인 + Claude API 직접 연결
권장 managed settings	`forceLoginMethod`, `forceLoginOrgUUID`, `allowedProviders`, `cleanupPeriodDays`
정책 확인	`/status`의 `Organization configuration` 줄에 `HIPAA`

상세

configuration 적용 전 컴퓨터 준비

이 섹션의 작업은 configuration이 적용되기 전에 시작해 끝내는 것을 권장합니다.

개발자 로그인·연결 방식 확인

HIPAA configuration은 개발자가 Claude Enterprise 계정으로 로그인하고 Claude Code가 Claude API에 직접 연결된 세션에서만 효력이 있습니다. 다른 연결에서도 Claude Code는 계속 쓸 수 있지만 HIPAA configuration이 적용되지 않습니다. "아니요" 행의 세션을 BAA가 다루는지는 위 지원 문서를 보세요.

Claude Code 연결 방식	HIPAA configuration 대상
Claude Enterprise 계정, Claude API 직접 연결	예
Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, Claude apps gateway	아니요
LLM gateway 또는 그 밖의 커스텀 `ANTHROPIC_BASE_URL`	아니요
Claude Enterprise 로그인이 없는 컴퓨터의 `ANTHROPIC_AUTH_TOKEN` 또는 `apiKeyHelper`	아니요
Claude Console API key 또는 federation credentials	아니요. 이 세션은 자체 계약·설정을 가진 Claude Console 조직에 속함

컴퓨터의 연결 방식 확인: 터미널에서 claude를 실행하고 프롬프트에 /status를 입력합니다. Status 탭에 다음 줄이 나옵니다.

줄	표시 조건
`Login method`, `Organization`	claude.ai 계정으로 로그인한 세션. Claude Enterprise 계정이면 `Login method`가 `Claude Enterprise account`, `Organization`에 조직 이름
`API provider`	cloud provider나 Claude apps gateway를 쓰는 세션에서만
`Anthropic base URL`	`ANTHROPIC_BASE_URL`이 설정된 경우에만

대상이 아닌 연결을 쓰는 컴퓨터는 managed settings로 cloud provider, gateway, ANTHROPIC_API_KEY·ANTHROPIC_AUTH_TOKEN·apiKeyHelper 자격 증명을 차단할 수 있습니다.

Claude Code와 Claude Desktop 업데이트

HIPAA configuration에는 Claude Code v2.1.285 이상과 Claude Desktop v2.19675.0 이상이 필요합니다. 터미널과 Claude Desktop 앱을 모두 쓰면 둘 다 업데이트합니다.

설치된 Claude Code 버전은 다음 명령으로 확인합니다. Bash, Zsh, PowerShell 모두 같습니다.

claude --version

지원 버전이면 2.1.285 (Claude Code) 이상이 출력됩니다. Claude Desktop 버전은 Check your version을 보세요.

구버전에서 개발자가 보는 것: HIPAA configuration 조직에서는 Anthropic 서버가 최소 버전보다 오래된 버전의 요청을 거부합니다. Anthropic은 최소 버전을 점차 올리며, 따로 설정할 것은 없습니다.

앱	구버전에서 보이는 것
Claude Code	모든 요청이 조직 정책이 요구하는 최소 버전보다 오래됐다는 `API Error`로 실패
Claude Desktop	Code 탭을 계속 쓰려면 업데이트하라는 Update required 대화상자

지원 버전을 유지하려면 Claude Code를 계속 업데이트합니다. Claude Desktop은 Update Claude Desktop을 보세요.

네트워크 접근 허용

다음 호스트를 proxy와 방화벽에서 HTTPS 443 포트로 허용합니다. 개별 경로가 아니라 호스트 전체를 허용합니다.

호스트	용도
`api.anthropic.com`	Claude API 요청, telemetry, HIPAA configuration이 켜졌음을 알려 주는 조직 정책
`claude.ai`, `claude.com`, `platform.claude.com`	로그인과 토큰 갱신
`sso.claude.com`	조직이 SSO를 쓸 때 로그인
`downloads.claude.ai`	native installer와 업데이트
`mcp-proxy.anthropic.com`	claude.ai의 connector

이 표는 터미널에서 Claude Code native 설치가 로그인·실행·업데이트에 필요한 호스트입니다. 나머지는 다음 페이지에 있습니다.

다른 설치 방식과 선택 기능: Network access requirements에 npm·Homebrew 설치의 업데이트 확인 호스트와 플러그인 설치 등 기능별 호스트가 있습니다.
Code 탭과 Cowork: Desktop network access requirements에 Claude Desktop의 추가 호스트가 있습니다.
TLS를 검사하는 proxy: Custom CA certificates에서 proxy 인증서를 신뢰하는 방법을 봅니다.

회사 HTTPS proxy를 거치는 세션도 proxy가 표의 호스트에 닿을 수 있으면 HIPAA configuration 대상입니다.

Claude Code는 시작할 때, 그리고 세션 사용 중 약 1시간마다 api.anthropic.com에서 조직 정책을 가져와 HIPAA configuration 여부를 압니다. 정책은 조직의 HIPAA 상태와 그에 따른 기능 제한의 기록입니다.

managed settings 배포

managed settings로 개발자가 Claude Enterprise 계정으로 로그인하도록 하고, cloud provider·gateway를 차단하고, 모든 컴퓨터가 로컬 세션 데이터를 보관할 일수를 정할 수 있습니다. 이 설정은 HIPAA configuration 적용 여부와 관계없이 적용됩니다.

아래는 출발점으로 권장하는 예시이며, 환경에 무엇이 필요한지 판단하고 설정이 그 요구를 충족하는지 확인하는 것은 조직의 책임입니다. 조직이 배포하는 managed settings에 추가할 수 있는 네 개 키입니다.

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "allowedProviders": ["anthropic"],
  "cleanupPeriodDays": 30
}

sandboxing, 네트워크 allowlist, 자격 증명 보호, 로컬 데이터 보관까지 포함한 더 완전한 managed-settings.json은 settings examples 저장소의 settings-hipaa.json과 README-hipaa.md를 보세요.

각 키의 역할

키	설정 값	Claude Code가 강제하는 것
`forceLoginMethod`	`"claudeai"`	Claude Console 대신 claude.ai 로그인으로 유도
`forceLoginOrgUUID`	조직 ID. Owner가 claude.ai admin settings에서 복사	claude.ai 로그인이 다른 조직 소속이면 시작 시 종료
`allowedProviders`	`["anthropic"]`	cloud provider나 gateway에서 시작을 거부
`cleanupPeriodDays`	기록 정책상 컴퓨터가 세션 데이터를 보관할 수 있는 일수	모든 컴퓨터가 같은 일수 후 오래된 세션 데이터를 삭제

배포 전에 forceLoginOrgUUID 값을 확인하세요. 조직 ID와 다르면 claude.ai 계정으로 로그인하는 모든 개발자의 Claude Code가 시작 시 종료됩니다.

HIPAA configuration은 cleanupPeriodDays를 제한하지 않으므로 개발자가 자기 설정에서 값을 올릴 수 있습니다. managed settings에 설정하면 개발자 값은 무시됩니다.
forceLoginMethod나 forceLoginOrgUUID가 설정되면 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper로 인증하는 세션도 거부합니다.

설정 로드 확인: 설정이 있는 컴퓨터에서 claude를 실행해 Claude Enterprise 계정으로 로그인하고 /status를 입력합니다. Setting sources 줄에 Enterprise managed settings와 괄호 속 출처(예: (file))가, Allowed providers 줄에 Anthropic API (managed allowedProviders)가 나와야 합니다. Setting sources에 없거나 Allowed providers 줄이 없으면 Check that a policy is in force를 보세요.

managed settings 키로 막히지 않는 세션: 이 키를 배포해도 일부 세션은 HIPAA configuration 없이 실행될 수 있습니다.

Claude Console 로그인과 federation credentials: forceLoginOrgUUID는 claude.ai 로그인만 검사합니다. 로그인 경로·자격 증명별 검사 내용은 Restrict login to your organization에 있습니다.
Server-managed settings: 조직이 server-managed settings도 쓴다면 Owner가 같은 키를 거기에도 추가해야 합니다. 어느 출처가 적용되는지는 How Claude Code combines managed sources를 보세요.
v2.1.285 미만 버전: allowedProviders를 무시하므로 cloud provider나 gateway에서 시작될 수 있습니다. v2.1.163~v2.1.284가 시작을 거부하게 하려면 같은 managed settings에 requiredMinimumVersion을 "2.1.285"로 추가합니다. v2.1.163 이전 버전은 requiredMinimumVersion과 allowedProviders를 모두 무시하므로 해당 컴퓨터는 업데이트해야 합니다.

HIPAA configuration 없이 실행되는 세션을 BAA가 다루는지는 지원 문서를 보세요.

Claude Desktop 로그인 제한

개발자가 Claude Desktop의 Code 탭을 쓴다면 Claude Desktop policy에도 forceLoginOrgUUID를 설정합니다. 방법은 Restrict sign-in to your organization에 있습니다. managed settings에 forceLoginMethod와 forceLoginOrgUUID를 배포해도 Claude Desktop 로그인 화면은 바뀌지 않습니다.

컴퓨터에서 configuration 확인

조직에 configuration이 적용된 뒤 관리 대상 컴퓨터 한 대에서 확인합니다.

Claude Code 재시작: 실행 중인 세션을 종료하고 터미널에서 claude를 실행합니다. 사용 중인 세션은 재시작하지 않아도 약 1시간 안에 configuration을 반영하며, 재시작하면 즉시 가져옵니다.
시작 안내 확인: 시작 시 Per your organization's policy, some features are limited · /status for details가 출력되는지 확인합니다.
footer 확인: 프롬프트 아래 footer 오른쪽에 HIPAA configured 태그가 있는지 확인합니다. v2.1.286 이전에는 태그가 HIPAA였습니다.
/status 실행: Status 탭의 Organization configuration 줄에 HIPAA가 있는지 확인합니다.
Claude Desktop 확인: HIPAA configuration을 적용하면 조직의 Code 탭이 꺼집니다. Code 탭을 쓴다면 Owner가 Organization settings > Claude Code에서 Desktop 토글을 켜야 합니다. Cowork는 Confirm the HIPAA configuration in Claude Desktop을 보세요. Claude Desktop을 다시 로드하거나 다시 로그인한 뒤 제목 표시줄에 HIPAA configured 라벨이 있는지 확인합니다. Mac에서는 사이드바를 열어야 보입니다.

/status에 HIPAA가 없으면 다음 순서로 원인을 확인합니다.

잘못된 계정·연결: /status의 Organization 줄에 조직이 나오고 API provider·Anthropic base URL 줄이 없는지 확인합니다. 대상이 아닌 로그인·연결 방식은 위 연결 방식 표에 있습니다.
정책 가져오기 차단: /status의 Organization policy 줄에 원인이 나옵니다. 세션 밖에서는 claude doctor를 실행해 같은 줄을 읽으면 정책을 어디서 로드했는지, 왜 로드하지 못했는지 알 수 있습니다. proxy에서 api.anthropic.com을 허용하고 Claude Code를 재시작합니다.
configuration이 아직 적용되지 않음: Primary Owner에게 적용했는지 확인합니다.

개발자가 Claude Code에서 보는 변화

HIPAA configuration이 적용되면 터미널에서 일부 기능이 꺼지거나 다르게 동작합니다. 아래는 개발자가 가장 많이 물어볼 변화이며, Owner가 다시 켤 수 있는 것을 포함한 Claude Code·Cowork 전체 기능 목록은 HIPAA feature availability table에 있습니다.

개발자가 겪는 것	이유
WebFetch tool을 쓸 수 없음	WebFetch가 꺼짐. 웹 검색은 계속 동작
`--cloud`, `/teleport`, Remote Control이 거부됨	Cloud 세션과 Remote Control이 꺼짐
`/feedback`, `/bug`를 쓸 수 없음	피드백 제출이 꺼짐
Claude가 artifact를 게시할 수 없음	artifact 게시가 꺼짐
MCP tool이 처음부터 컨텍스트에 로드됨	MCP tool search가 꺼짐. `ENABLE_TOOL_SEARCH`나 managed settings로도 다시 켤 수 없음
`ANTHROPIC_API_KEY`를 읽는 MCP 서버나 hook이 인증에 실패	Claude Code가 자신이 띄우는 프로세스에서 Anthropic 자격 증명을 제거
다른 조직으로 `/login`해도 제한이 남음	HIPAA 상태는 Claude Code를 재시작할 때까지 유지

명령·hook·MCP 서버의 Anthropic 자격 증명

HIPAA configuration이 적용되면 Claude Code는 자신이 띄우는 shell 명령, hook, MCP 서버의 환경에서 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN 등 Anthropic 접속용 자격 증명을 제거합니다.

cloud provider나 GitHub 자격 증명은 제거하지 않으므로, GitHub에 push하거나 다른 서비스를 호출하는 명령은 그 개발자의 권한으로 계속 동작합니다. 그쪽으로 보내는 데이터는 Anthropic과의 BAA가 다루지 않습니다. Eligible Services 전체 목록은 Implementation Guide를 보세요. Claude가 쓸 수 있는 명령·호스트를 제한하려면 permission rules와 sandbox를 보세요.

로컬 세션 데이터 관리

Claude Code (local mode)와 Cowork (local mode)는 각 개발자 컴퓨터에 세션 데이터를 저장합니다. 이 데이터의 보호와 삭제는 조직의 책임입니다.

Claude Code 데이터

Application data에 Claude Code (local mode)가 컴퓨터에 저장하는 것, cleanupPeriodDays 후 retention sweep이 지우는 것, 누군가 지울 때까지 남는 것이 정리되어 있습니다. HIPAA configuration 조직에서 달라지는 점도 같은 페이지에 있습니다. retention sweep은 누군가 Claude Code를 시작할 때만 실행되므로, 아무도 시작하지 않는 컴퓨터는 데이터를 계속 보관합니다.

Code 탭 데이터

Transcript: 터미널 transcript와 함께 ~/.claude/projects/에 저장됩니다. retention sweep이 언제 지우는지는 Cleaned up automatically를 보세요.
Claude Desktop 데이터 폴더: macOS는 ~/Library/Application Support/Claude. Windows는 %APPDATA%\Claude, 또는 Anthropic에서 내려받은 installer라면 %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude이므로 둘 다 확인합니다. HIPAA configuration이 적용되면 Claude Desktop은 cleanupPeriodDays보다 오래 비활성인 로컬 Code 탭 세션을 별표 표시된 것까지 삭제합니다. 삭제는 Claude Desktop이 실행 중일 때만 일어납니다. 삭제된 세션의 worktree는 다음과 같이 처리됩니다.
- 커밋되지 않은 변경이 없고, 세션이 별표·고정되지 않았고, 다른 세션이 worktree를 쓰지 않음: worktree 제거
- 그 외: worktree가 컴퓨터에 남음

Windows에서 ~는 %USERPROFILE%입니다.

Cowork 데이터

Cowork (local mode)의 저장 위치와 Claude Desktop이 지우는 것은 Manage Cowork data on each computer에 있습니다.

세션 데이터 즉시 삭제

retention sweep 전에 개발자의 세션 데이터를 지워야 하면 명령 하나로 대부분을 제거할 수 있습니다. 그 개발자로 컴퓨터에 로그인해 아무 shell에서 설치된 버전에 맞는 명령을 실행합니다.

Claude Code v2.1.288 이상:

claude purge --all --yes

v2.1.126~v2.1.287은 같은 플래그를 받는 claude project purge:

claude project purge --all --yes

두 명령 모두 모든 프로젝트의 transcript와 auto memory, tasks/·debug/·file-history/의 항목, history.jsonl, ~/.claude.json의 프로젝트 항목을 지웁니다. --yes 없이 실행하면 계획을 출력하고 먼저 묻습니다.

purge는 paste-cache/의 붙여넣은 텍스트처럼 세션 내용이 들어 있을 수 있는 다른 경로를 남깁니다. 직접 지울 수 있는 경로는 Clear local data에 있습니다. 재배정 전처럼 컴퓨터를 완전히 비우려면 아래처럼 wipe합니다.

개발자 offboarding

개발자의 seat이나 계정을 제거해도 컴퓨터의 데이터는 지워지지 않으며, /logout도 세션 데이터를 지우지 않습니다. 전부 지우려면 기기 관리 도구로 컴퓨터를 wipe합니다.

체크리스트

개발자가 Claude Enterprise 계정 + Claude API 직접 연결로 쓰는지 /status로 확인했다.
Claude Code v2.1.285 이상, Claude Desktop v2.19675.0 이상으로 업데이트했다.
api.anthropic.com, claude.ai, claude.com, platform.claude.com, sso.claude.com, downloads.claude.ai, mcp-proxy.anthropic.com을 443 포트로 허용했다.
forceLoginMethod, forceLoginOrgUUID(값 재확인), allowedProviders, cleanupPeriodDays를 managed settings로 배포했다.
구버전 대비 requiredMinimumVersion: "2.1.285"를 검토했고, server-managed settings에도 같은 키를 넣었다.
Code 탭을 쓰면 Claude Desktop policy에도 forceLoginOrgUUID를 설정했다.
적용 후 시작 안내, footer의 HIPAA configured, /status의 Organization configuration을 확인했다.
Code 탭이 필요하면 Owner가 Desktop 토글을 다시 켰다.
세션 데이터 즉시 삭제(claude purge / claude project purge)와 offboarding wipe 절차를 정했다.

다음 단계

기준일

이 문서는 2026-10-23에 공식 Set up Claude Code (local mode) for a HIPAA-ready organization 페이지를 기준으로 작성했습니다. 버전 표기(v2.1.126, v2.1.163, v2.1.284~v2.1.288, Claude Desktop v2.19675.0)는 모두 공식 원문에 있는 내용입니다.

HIPAA 조직용 Claude Code (local mode) 설정 (Set up Claude Code for a HIPAA-ready organization)

기준일: 2026-10-23
공식 기준: Set up Claude Code (local mode) for a HIPAA-ready organization

개요

"(local mode)"는 cloud 세션이 아닌 로컬 세션을 뜻합니다. 로컬 세션은 다음 중 하나에서 실행됩니다.

터미널의 Claude Code
Claude Desktop Code 탭의 Claude Code
Claude Desktop의 Cowork

핵심 개념

시점	할 일
configuration 적용 전	컴퓨터 준비: 개발자 연결 방식 확인, 앱 업데이트, 네트워크 허용, managed settings 배포, Claude Desktop 로그인 제한
적용 후	Owner가 다시 켤 때까지 Code 탭이 꺼짐. 컴퓨터에서 configuration 확인
지속	로컬 세션 데이터 관리

항목	값
최소 버전	Claude Code v2.1.285 이상, Claude Desktop v2.19675.0 이상
적용 조건	Claude Enterprise 계정 로그인 + Claude API 직접 연결
권장 managed settings	`forceLoginMethod`, `forceLoginOrgUUID`, `allowedProviders`, `cleanupPeriodDays`
정책 확인	`/status`의 `Organization configuration` 줄에 `HIPAA`

상세

configuration 적용 전 컴퓨터 준비

이 섹션의 작업은 configuration이 적용되기 전에 시작해 끝내는 것을 권장합니다.

개발자 로그인·연결 방식 확인

Claude Code 연결 방식	HIPAA configuration 대상
Claude Enterprise 계정, Claude API 직접 연결	예
Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, Claude apps gateway	아니요
LLM gateway 또는 그 밖의 커스텀 `ANTHROPIC_BASE_URL`	아니요
Claude Enterprise 로그인이 없는 컴퓨터의 `ANTHROPIC_AUTH_TOKEN` 또는 `apiKeyHelper`	아니요
Claude Console API key 또는 federation credentials	아니요. 이 세션은 자체 계약·설정을 가진 Claude Console 조직에 속함

컴퓨터의 연결 방식 확인: 터미널에서 claude를 실행하고 프롬프트에 /status를 입력합니다. Status 탭에 다음 줄이 나옵니다.

줄	표시 조건
`Login method`, `Organization`	claude.ai 계정으로 로그인한 세션. Claude Enterprise 계정이면 `Login method`가 `Claude Enterprise account`, `Organization`에 조직 이름
`API provider`	cloud provider나 Claude apps gateway를 쓰는 세션에서만
`Anthropic base URL`	`ANTHROPIC_BASE_URL`이 설정된 경우에만

대상이 아닌 연결을 쓰는 컴퓨터는 managed settings로 cloud provider, gateway, ANTHROPIC_API_KEY·ANTHROPIC_AUTH_TOKEN·apiKeyHelper 자격 증명을 차단할 수 있습니다.

Claude Code와 Claude Desktop 업데이트

HIPAA configuration에는 Claude Code v2.1.285 이상과 Claude Desktop v2.19675.0 이상이 필요합니다. 터미널과 Claude Desktop 앱을 모두 쓰면 둘 다 업데이트합니다.

설치된 Claude Code 버전은 다음 명령으로 확인합니다. Bash, Zsh, PowerShell 모두 같습니다.

claude --version

지원 버전이면 2.1.285 (Claude Code) 이상이 출력됩니다. Claude Desktop 버전은 Check your version을 보세요.

앱	구버전에서 보이는 것
Claude Code	모든 요청이 조직 정책이 요구하는 최소 버전보다 오래됐다는 `API Error`로 실패
Claude Desktop	Code 탭을 계속 쓰려면 업데이트하라는 Update required 대화상자

지원 버전을 유지하려면 Claude Code를 계속 업데이트합니다. Claude Desktop은 Update Claude Desktop을 보세요.

네트워크 접근 허용

다음 호스트를 proxy와 방화벽에서 HTTPS 443 포트로 허용합니다. 개별 경로가 아니라 호스트 전체를 허용합니다.

호스트	용도
`api.anthropic.com`	Claude API 요청, telemetry, HIPAA configuration이 켜졌음을 알려 주는 조직 정책
`claude.ai`, `claude.com`, `platform.claude.com`	로그인과 토큰 갱신
`sso.claude.com`	조직이 SSO를 쓸 때 로그인
`downloads.claude.ai`	native installer와 업데이트
`mcp-proxy.anthropic.com`	claude.ai의 connector

이 표는 터미널에서 Claude Code native 설치가 로그인·실행·업데이트에 필요한 호스트입니다. 나머지는 다음 페이지에 있습니다.

다른 설치 방식과 선택 기능: Network access requirements에 npm·Homebrew 설치의 업데이트 확인 호스트와 플러그인 설치 등 기능별 호스트가 있습니다.
Code 탭과 Cowork: Desktop network access requirements에 Claude Desktop의 추가 호스트가 있습니다.
TLS를 검사하는 proxy: Custom CA certificates에서 proxy 인증서를 신뢰하는 방법을 봅니다.

회사 HTTPS proxy를 거치는 세션도 proxy가 표의 호스트에 닿을 수 있으면 HIPAA configuration 대상입니다.

managed settings 배포

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "allowedProviders": ["anthropic"],
  "cleanupPeriodDays": 30
}

각 키의 역할

키	설정 값	Claude Code가 강제하는 것
`forceLoginMethod`	`"claudeai"`	Claude Console 대신 claude.ai 로그인으로 유도
`forceLoginOrgUUID`	조직 ID. Owner가 claude.ai admin settings에서 복사	claude.ai 로그인이 다른 조직 소속이면 시작 시 종료
`allowedProviders`	`["anthropic"]`	cloud provider나 gateway에서 시작을 거부
`cleanupPeriodDays`	기록 정책상 컴퓨터가 세션 데이터를 보관할 수 있는 일수	모든 컴퓨터가 같은 일수 후 오래된 세션 데이터를 삭제

배포 전에 forceLoginOrgUUID 값을 확인하세요. 조직 ID와 다르면 claude.ai 계정으로 로그인하는 모든 개발자의 Claude Code가 시작 시 종료됩니다.

HIPAA configuration은 cleanupPeriodDays를 제한하지 않으므로 개발자가 자기 설정에서 값을 올릴 수 있습니다. managed settings에 설정하면 개발자 값은 무시됩니다.
forceLoginMethod나 forceLoginOrgUUID가 설정되면 ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper로 인증하는 세션도 거부합니다.

managed settings 키로 막히지 않는 세션: 이 키를 배포해도 일부 세션은 HIPAA configuration 없이 실행될 수 있습니다.

Claude Console 로그인과 federation credentials: forceLoginOrgUUID는 claude.ai 로그인만 검사합니다. 로그인 경로·자격 증명별 검사 내용은 Restrict login to your organization에 있습니다.
Server-managed settings: 조직이 server-managed settings도 쓴다면 Owner가 같은 키를 거기에도 추가해야 합니다. 어느 출처가 적용되는지는 How Claude Code combines managed sources를 보세요.
v2.1.285 미만 버전: allowedProviders를 무시하므로 cloud provider나 gateway에서 시작될 수 있습니다. v2.1.163~v2.1.284가 시작을 거부하게 하려면 같은 managed settings에 requiredMinimumVersion을 "2.1.285"로 추가합니다. v2.1.163 이전 버전은 requiredMinimumVersion과 allowedProviders를 모두 무시하므로 해당 컴퓨터는 업데이트해야 합니다.

HIPAA configuration 없이 실행되는 세션을 BAA가 다루는지는 지원 문서를 보세요.

Claude Desktop 로그인 제한

컴퓨터에서 configuration 확인

조직에 configuration이 적용된 뒤 관리 대상 컴퓨터 한 대에서 확인합니다.

Claude Code 재시작: 실행 중인 세션을 종료하고 터미널에서 claude를 실행합니다. 사용 중인 세션은 재시작하지 않아도 약 1시간 안에 configuration을 반영하며, 재시작하면 즉시 가져옵니다.
시작 안내 확인: 시작 시 Per your organization's policy, some features are limited · /status for details가 출력되는지 확인합니다.
footer 확인: 프롬프트 아래 footer 오른쪽에 HIPAA configured 태그가 있는지 확인합니다. v2.1.286 이전에는 태그가 HIPAA였습니다.
/status 실행: Status 탭의 Organization configuration 줄에 HIPAA가 있는지 확인합니다.
Claude Desktop 확인: HIPAA configuration을 적용하면 조직의 Code 탭이 꺼집니다. Code 탭을 쓴다면 Owner가 Organization settings > Claude Code에서 Desktop 토글을 켜야 합니다. Cowork는 Confirm the HIPAA configuration in Claude Desktop을 보세요. Claude Desktop을 다시 로드하거나 다시 로그인한 뒤 제목 표시줄에 HIPAA configured 라벨이 있는지 확인합니다. Mac에서는 사이드바를 열어야 보입니다.

/status에 HIPAA가 없으면 다음 순서로 원인을 확인합니다.

잘못된 계정·연결: /status의 Organization 줄에 조직이 나오고 API provider·Anthropic base URL 줄이 없는지 확인합니다. 대상이 아닌 로그인·연결 방식은 위 연결 방식 표에 있습니다.
정책 가져오기 차단: /status의 Organization policy 줄에 원인이 나옵니다. 세션 밖에서는 claude doctor를 실행해 같은 줄을 읽으면 정책을 어디서 로드했는지, 왜 로드하지 못했는지 알 수 있습니다. proxy에서 api.anthropic.com을 허용하고 Claude Code를 재시작합니다.
configuration이 아직 적용되지 않음: Primary Owner에게 적용했는지 확인합니다.

개발자가 Claude Code에서 보는 변화

개발자가 겪는 것	이유
WebFetch tool을 쓸 수 없음	WebFetch가 꺼짐. 웹 검색은 계속 동작
`--cloud`, `/teleport`, Remote Control이 거부됨	Cloud 세션과 Remote Control이 꺼짐
`/feedback`, `/bug`를 쓸 수 없음	피드백 제출이 꺼짐
Claude가 artifact를 게시할 수 없음	artifact 게시가 꺼짐
MCP tool이 처음부터 컨텍스트에 로드됨	MCP tool search가 꺼짐. `ENABLE_TOOL_SEARCH`나 managed settings로도 다시 켤 수 없음
`ANTHROPIC_API_KEY`를 읽는 MCP 서버나 hook이 인증에 실패	Claude Code가 자신이 띄우는 프로세스에서 Anthropic 자격 증명을 제거
다른 조직으로 `/login`해도 제한이 남음	HIPAA 상태는 Claude Code를 재시작할 때까지 유지

명령·hook·MCP 서버의 Anthropic 자격 증명

로컬 세션 데이터 관리

Claude Code (local mode)와 Cowork (local mode)는 각 개발자 컴퓨터에 세션 데이터를 저장합니다. 이 데이터의 보호와 삭제는 조직의 책임입니다.

Claude Code 데이터

Code 탭 데이터

Transcript: 터미널 transcript와 함께 ~/.claude/projects/에 저장됩니다. retention sweep이 언제 지우는지는 Cleaned up automatically를 보세요.
Claude Desktop 데이터 폴더: macOS는 ~/Library/Application Support/Claude. Windows는 %APPDATA%\Claude, 또는 Anthropic에서 내려받은 installer라면 %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude이므로 둘 다 확인합니다. HIPAA configuration이 적용되면 Claude Desktop은 cleanupPeriodDays보다 오래 비활성인 로컬 Code 탭 세션을 별표 표시된 것까지 삭제합니다. 삭제는 Claude Desktop이 실행 중일 때만 일어납니다. 삭제된 세션의 worktree는 다음과 같이 처리됩니다.
- 커밋되지 않은 변경이 없고, 세션이 별표·고정되지 않았고, 다른 세션이 worktree를 쓰지 않음: worktree 제거
- 그 외: worktree가 컴퓨터에 남음

Windows에서 ~는 %USERPROFILE%입니다.

Cowork 데이터

Cowork (local mode)의 저장 위치와 Claude Desktop이 지우는 것은 Manage Cowork data on each computer에 있습니다.

세션 데이터 즉시 삭제

Claude Code v2.1.288 이상:

claude purge --all --yes

v2.1.126~v2.1.287은 같은 플래그를 받는 claude project purge:

claude project purge --all --yes

개발자 offboarding

체크리스트

개발자가 Claude Enterprise 계정 + Claude API 직접 연결로 쓰는지 /status로 확인했다.
Claude Code v2.1.285 이상, Claude Desktop v2.19675.0 이상으로 업데이트했다.
api.anthropic.com, claude.ai, claude.com, platform.claude.com, sso.claude.com, downloads.claude.ai, mcp-proxy.anthropic.com을 443 포트로 허용했다.
forceLoginMethod, forceLoginOrgUUID(값 재확인), allowedProviders, cleanupPeriodDays를 managed settings로 배포했다.
구버전 대비 requiredMinimumVersion: "2.1.285"를 검토했고, server-managed settings에도 같은 키를 넣었다.
Code 탭을 쓰면 Claude Desktop policy에도 forceLoginOrgUUID를 설정했다.
적용 후 시작 안내, footer의 HIPAA configured, /status의 Organization configuration을 확인했다.
Code 탭이 필요하면 Owner가 Desktop 토글을 다시 켰다.
세션 데이터 즉시 삭제(claude purge / claude project purge)와 offboarding wipe 절차를 정했다.

HIPAA 조직용 Claude Code (local mode) 설정 (Set up Claude Code for a HIPAA-ready organization)

개요

핵심 개념

상세

configuration 적용 전 컴퓨터 준비

개발자 로그인·연결 방식 확인

Claude Code와 Claude Desktop 업데이트

네트워크 접근 허용

managed settings 배포

Claude Desktop 로그인 제한

컴퓨터에서 configuration 확인

개발자가 Claude Code에서 보는 변화

명령·hook·MCP 서버의 Anthropic 자격 증명

로컬 세션 데이터 관리

Claude Code 데이터

Code 탭 데이터

Cowork 데이터

세션 데이터 즉시 삭제

개발자 offboarding

체크리스트

다음 단계

기준일

관련 가이드

HIPAA 조직용 Claude Code (local mode) 설정 (Set up Claude Code for a HIPAA-ready organization)

개요

핵심 개념

상세

configuration 적용 전 컴퓨터 준비

개발자 로그인·연결 방식 확인

Claude Code와 Claude Desktop 업데이트

네트워크 접근 허용

managed settings 배포

Claude Desktop 로그인 제한

컴퓨터에서 configuration 확인

개발자가 Claude Code에서 보는 변화

명령·hook·MCP 서버의 Anthropic 자격 증명

로컬 세션 데이터 관리

Claude Code 데이터

Code 탭 데이터

Cowork 데이터

세션 데이터 즉시 삭제

개발자 offboarding

체크리스트

다음 단계

기준일

관련 가이드