앱 테스트 및 검토
새 Linked billing 앱이 테스트 단계를 벗어나 고객에게 공개되는 과정과, 라이브 앱을 변경할 때 일어나는 일을 설명합니다.
Linked billing을 사용하면 고객이 자신의 Claude 조직을 OAuth 앱에 연결합니다. 새 Linked billing 앱은 테스트 단계에서 시작하며, 이 단계에서는 지정한 테스트 사용자만 자신의 조직을 앱에 연결할 수 있습니다. 앱을 고객에게 공개하려면 앱을 게시하고, Anthropic이 앱을 검토합니다.
조직이 인보이스 결제를 사용하는 경우 Anthropic은 앱을 검토하지 않습니다. 인보이스 결제를 참조하세요.
Anthropic이 앱을 승인했거나 인보이스 결제로 앱을 게시한 경우 앱은 라이브 상태입니다. 모든 대상 고객이 자신의 조직을 라이브 앱에 연결할 수 있으며, 테스트 사용자가 만든 연결은 유지됩니다. Claude Console의 OAuth 앱 페이지에서 라이브 앱의 상태는 Active로 표시됩니다.
앱이 라이브 상태가 될 때까지 Console에는 앱에 대해 다음 상태 중 하나가 표시됩니다.
| 상태 | 의미 |
|---|---|
| Testing | 앱을 게시하지 않았습니다. |
| In review | Anthropic이 앱 또는 앱이 라이브 상태일 때 변경한 사항을 검토하고 있습니다. |
| Not approved | Anthropic이 앱 또는 변경 사항을 검토했으며 승인하지 않았습니다. |
변경 후 다시 검토 단계로 돌아간 앱은 Anthropic이 변경 사항을 승인할 때까지 다시 라이브 상태가 되지 않습니다. 각 Linked billing 앱에는 자체 상태와 자체 테스트 사용자가 있습니다. Linked billing 가이드의 1단계: 앱 만들기에 있는 참고 사항을 참조하세요.
시작하기 전에
Linked billing 가이드의 설정 과정을 완료하세요.
테스트 사용자 관리
테스트 사용자 추가
- Console의 OAuth 앱 페이지에서 앱의 페이지를 여세요.
- Settings 탭에서 Who can link 아래의 Test users 목록으로 이동하세요.
- 테스트 사용자의 Claude 계정 이메일 주소를 입력하고 Add를 클릭하세요. 각 테스트 사용자에 대해 반복하세요.
- Save changes를 클릭하세요.
저장한 후에는 목록에 있는 사람들이 자신의 조직을 앱에 연결할 수 있습니다. 앱이 라이브 상태가 될 때까지, 사용자가 연결을 승인하는 Claude 승인 페이지는 그 외의 사람을 거부합니다. 이때 앱이 받는 내용은 Linked billing 가이드의 리디렉션 URI가 error=access_denied를 받는 경우를 참조하세요.
앱이 라이브 상태가 아닌 동안 Who can link는 Test users only로 유지되며, 이 설정은 변경할 수 없습니다. 목록에는 최대 10명의 테스트 사용자를 추가할 수 있습니다. 각 주소는 계정의 주소와 정확히 일치해야 하지만, 대소문자는 구분하지 않습니다. name+test@example.com과 같이 플러스 태그가 있는 주소는 name@example.com과 다른 주소로 간주됩니다.
테스트 사용자의 조직 연결
테스트 사용자는 앱에서 자신의 조직을 연결하고, 고객이 사용하는 것과 동일한 페이지에서 연결을 승인합니다. 테스트 사용자는 해당 조직에서 Admin 또는 Billing 역할을 가지고 있어야 합니다. 단계는 Linked billing 가이드의 4~8단계입니다. 해당 가이드의 고객으로 테스트하기에서 이 단계를 안내하며, 연결이 만들어졌는지 확인하는 방법도 설명합니다.
직접 앱을 테스트하려면 목록에 본인의 이메일 주소를 추가하세요. 앱을 소유한 조직은 앱에 연결할 수 없으므로, 본인이 보유한 두 번째 Claude 조직을 사용하세요.
테스트 사용자가 자신의 조직을 연결한 후에는 해당 조직에 청구하는 요청을 보내 앱을 사용해 보세요. 테스트에는 실제 비용이 발생합니다. Anthropic은 다른 고객과 마찬가지로, 각 테스트 사용자의 조직에 청구한 요청에 대해 해당 조직에 요금을 부과합니다.
앱이 라이브 상태가 될 때까지 각 새 연결에는 $50 USD 이하의 월간 “spend cap”(지출 한도)이 필요합니다. 한도의 규칙은 가이드의 앱이 테스트 중인 동안을 참조하세요.
테스트 사용자 제거
테스트 사용자 제거는 즉시 적용됩니다. 해당 사용자가 승인한 앱과의 모든 연결이 종료됩니다. 연결이 종료되면 Claude API는 해당 조직에 청구하는 요청을 거부합니다. 예상되는 오류를 참조하세요.
- Settings 탭에 저장되지 않은 변경 사항이 있으면 Save changes 또는 Discard를 클릭하세요. 그렇게 하기 전까지는 Console에서 저장된 테스트 사용자를 제거할 수 없습니다.
- Test users 목록에서 테스트 사용자의 주소를 삭제하세요.
- Console에서 확인을 요청하면 Remove를 클릭하여 확인하세요. Save changes를 클릭할 필요는 없습니다.
앱 게시
게시 과정에서는 DNS 레코드를 추가하여 앱의 도메인을 제어하고 있음을 증명하도록 요청할 수 있습니다. 그런 다음 Anthropic이 앱을 검토합니다. DNS 변경에는 시간이 걸리므로, 고객의 연결이 필요해지기 전에 시작하세요.
게시하기 전에 다음 사항을 확인하세요.
- 클라이언트 인증이 설정되어 있습니다. 클라이언트 인증이 설정되기 전까지는 앱을 게시할 수 없습니다.
- 앱에 Appearance 탭에서 설정한 홈페이지가 있습니다.
- 홈페이지 도메인의 DNS 레코드를 변경할 수 있습니다.
- 각 “redirect URI”(리디렉션 URI)가 홈페이지의 도메인 또는 그 하위 도메인 중 하나에 있습니다.
무엇이 홈페이지의 도메인으로 간주되는지와 예외 사항은 도메인 규칙을 참조하세요.
앱을 게시하려면 다음 단계를 따르세요.
- Console의 앱 페이지에서 Publish app을 클릭하세요. 대화 상자가 열립니다.
- 대화 상자에 Prove your domain이 표시되면, 도메인의 DNS를 관리하는 곳에서 대화 상자가 제공하는 DNS TXT 레코드를 추가하세요. 그렇지 않으면 5단계로 이동하세요.
- Check를 클릭하세요. 도메인에 여전히 Not proven yet이 표시되면 도메인을 증명할 수 없는 경우를 참조하세요.
- 도메인에 Proven이 표시되면 Continue를 클릭하세요.
- 대화 상자에 Linked Billing 약관에 동의하는 체크박스가 표시되면 해당 체크박스를 선택하세요. 그런 다음 대화 상자에서 Publish app을 클릭하여 확인하세요.
Anthropic이 앱을 검토하는 동안 앱의 상태는 In review입니다. 결과는 검토를 참조하세요.
도메인을 증명할 수 없는 경우
- 도메인에 여전히 Not proven yet이 표시되는 경우: DNS 변경 사항이 적용되기까지 최대 48시간이 걸릴 수 있습니다. 대화 상자를 닫고 나중에 돌아와도 됩니다. 게시 중이었다면 Publish app을 다시 클릭하세요. 라이브 앱을 변경 중이었다면 동일한 수정을 다시 하세요. Console은 레코드가 만료될 때까지 동일한 레코드를 제공합니다.
- Check에 레코드가 만료되었다고 표시되는 경우: DNS 레코드는 Console에 처음 표시된 시점부터 30일 동안 유효합니다. 그 이후에는 Get a new record를 클릭하고 새 레코드를 추가하세요. Proven이 표시된 도메인은 증명된 상태로 유지됩니다.
- 대화 상자에 레코드 대신 메시지가 표시되는 경우: 예를 들어 조직에 이미 도메인 이름이 20개 있다는 메시지가 표시될 수 있습니다. 이 문제가 해결될 때까지는 계속 진행할 수 없습니다. 도움이 필요하면 지원팀에 문의하세요.
도메인 규칙
도메인은 앞에 붙는 www.를 제외한 호스트 이름이며, 앱의 도메인은 홈페이지의 도메인입니다. 예를 들어 https://www.example.com에 있는 홈페이지의 도메인은 example.com입니다. 증명된 도메인은 자신과 그 하위 도메인을 포함합니다.
- 공유 도메인: 호스팅 서비스의 공유 도메인은 해당되지 않으므로 자체 도메인을 사용하세요.
- 로컬 리디렉션 URI:
localhost,127.0.0.1또는[::1]에 있는 리디렉션 URI는 홈페이지의 도메인에 있을 필요가 없습니다. - 형제 하위 도메인: 홈페이지가
app.example.com에 있으면 도메인은 해당 하위 도메인이며,auth.example.com에 있는 리디렉션 URI는 포함하지 않습니다. 둘 다 사용하는 한 가지 방법은 홈페이지를 두 도메인을 모두 포함하는example.com에 두는 것입니다. - 조직이 이미 증명한 도메인: 조직이 이전에 다른 앱 등을 위해 도메인을 증명했을 수 있습니다. 해당 도메인이 홈페이지와 로컬이 아닌 모든 리디렉션 URI를 포함하면, 대화 상자는 Prove your domain을 건너뜁니다. 이 경우 리디렉션 URI는 홈페이지의 도메인에 있을 필요가 없습니다. 예를 들어
example.com이 증명되어 있으면 홈페이지와 리디렉션 URI가 그 하위 도메인 중 서로 다른 곳에 있을 수 있습니다.
검토
검토가 끝나면 Console의 앱 페이지에 결과가 표시됩니다.
- Anthropic이 앱을 승인하는 경우: 앱이 라이브 상태가 됩니다. 그러면 별도의 조치 없이 Who can link에 Any Claude user가 표시되며, Console에서 Test users 목록이 숨겨집니다.
- Anthropic이 앱을 승인하지 않는 경우: 앱의 상태가 Not approved로 변경됩니다.
검토 기간 동안과 Not approved 결과가 나온 후에도 테스트 사용자는 기존 연결을 유지하며, 테스트 사용자를 계속 추가하고 제거할 수 있습니다.
앱이 승인되지 않은 경우
앱을 직접 다시 게시할 수는 없습니다. 결정에 대해 문의하려면 지원팀에 문의하세요. 여전히 앱을 변경할 수 있지만, 변경해도 새 검토가 시작되지 않습니다.
라이브 앱 변경
라이브 앱의 이름, 로고, 홈페이지 또는 리디렉션 URI를 변경하면 앱이 다시 검토 단계로 돌아갑니다. Anthropic이 변경 사항을 승인할 때까지는 테스트 사용자만 자신의 조직을 앱에 연결할 수 있습니다. Anthropic이 변경 사항을 승인할 때까지를 참조하세요. 권한이나 클라이언트 인증 등 다른 변경 사항은 앱을 다시 검토 단계로 보내지 않습니다.
이름, 홈페이지 또는 리디렉션 URI를 변경하려면 다음 단계를 따르세요.
- Appearance 탭(이름 및 홈페이지) 또는 Settings 탭(리디렉션 URI)에서 앱을 변경하세요.
- Save changes를 클릭하세요. 저장되기 전에 대화 상자가 열립니다.
- 대화 상자에 Prove your domain이 표시되면, 대화 상자가 지정하는 각 도메인을 증명하세요.
- 도메인에 대한 DNS TXT 레코드를 추가하세요. 그런 다음 Check를 클릭하세요. 도메인에 여전히 Not proven yet이 표시되면 도메인을 증명할 수 없는 경우를 참조하세요.
- 도메인에 Proven이 표시되면, 남은 도메인이 있으면 Next domain을 클릭하세요. 그렇지 않으면 Continue를 클릭하세요.
- Save and send to review를 클릭하세요.
그러면 Console이 변경 사항을 저장하고, 변경 사항은 검토를 기다리지 않고 적용됩니다. Anthropic이 변경 사항을 검토하는 동안 앱의 상태는 In review입니다.
로고를 변경하려면 Appearance 탭에서 로고를 선택하거나 제거하세요. 대화 상자가 즉시 열립니다. Send to review를 클릭하세요. 취소하면 로고가 변경되지 않습니다.
앱의 상태가 In review 또는 Not approved인 동안 앱을 다시 변경하려면 라이브 상태가 아닌 앱 변경을 참조하세요.
Console이 도메인 증명을 요청하는 경우
Console은 홈페이지 또는 리디렉션 URI를 변경한 경우에만 요청합니다. 변경하지 않은 홈페이지와 리디렉션 URI도 확인하므로, 대화 상자에 해당 도메인도 표시될 수 있습니다. 조직이 증명한 도메인에 포함되지 않는 도메인만 표시합니다. 로컬 리디렉션 URI는 확인하지 않지만, 이러한 URI를 변경해도 앱은 다시 검토 단계로 돌아갑니다.
변경 후에는 조직이 각 도메인을 증명하면 리디렉션 URI가 홈페이지 도메인이 아닌 다른 도메인에 있을 수 있습니다.
Anthropic이 변경 사항을 승인할 때까지
다음 규칙은 변경 사항을 검토 단계로 보낸 시점부터 적용됩니다.
- 이미 연결한 고객: 해당 조직은 연결된 상태로 유지되며, 이들에게 청구하는 요청은 계속 작동합니다. 연결을 해제한 고객은 연결하는 사람이 Test users 목록에 있지 않으면 다시 연결할 수 없습니다.
- 새 연결: Who can link 설정이 Test users only로 돌아갑니다. Console에 이전에 목록에 있던 사람들과 함께 Test users 목록이 다시 표시됩니다.
- 테스트 사용자: 목록에서 사람을 추가하고 제거할 수 있습니다. 사람을 제거하면 앱이 라이브 상태였을 때 해당 사용자가 고객의 조직과 만든 연결도 종료됩니다. 테스트 사용자 제거를 참조하세요.
- 연결된 조직의 지출 한도: 연결된 조직은 한도가 $50 USD를 초과하거나 한도가 없더라도 현재 지출 한도 설정을 유지합니다. 조직이 변경하는 설정은 앱이 테스트 중인 동안의 규칙을 따라야 합니다.
변경 사항 검토가 끝나는 경우
검토는 다음 두 가지 중 하나로 끝납니다.
- Anthropic이 변경 사항을 승인하는 경우: 앱이 다시 라이브 상태가 됩니다. 모든 대상 고객이 연결할 수 있고, Console에서 Test users 목록이 숨겨지며, 라이브 상태가 아닌 앱에 대한 한도 규칙은 더 이상 적용되지 않습니다.
- Anthropic이 변경 사항을 승인하지 않는 경우: 앱의 상태가 Not approved로 변경됩니다. 변경 사항은 계속 적용되며, Anthropic이 변경 사항을 승인할 때까지의 규칙이 여전히 적용됩니다. 앱이 승인되지 않은 경우를 참조하세요.
라이브 상태가 아닌 앱 변경
앱의 상태가 Testing, In review 또는 Not approved인 동안 다음 단계를 따르세요.
- Appearance 탭(이름, 로고 및 홈페이지) 또는 Settings 탭(리디렉션 URI)에서 앱을 변경하세요.
- Save changes를 클릭하세요. 로고 변경은 로고를 선택하거나 제거할 때 저장됩니다.
확인을 요청하는 대화 상자는 없으며, 변경해도 앱의 상태는 바뀌지 않습니다.
홈페이지 또는 리디렉션 URI 변경 사항을 저장할 때, Console은 상태가 In review인 동안에만 도메인을 확인합니다. 테스트 단계의 앱은 게시할 때 도메인 확인을 거칩니다. 검토 기간 동안에는 변경된 앱의 홈페이지와 로컬이 아닌 모든 리디렉션 URI가 조직이 증명한 도메인에 있어야 합니다. 그렇지 않으면 Console이 변경을 거부하며, 도메인 증명을 요청하지 않습니다. 증명되지 않은 도메인으로 이동하려면 검토가 끝날 때까지 기다리세요.
인보이스 결제
인보이스 결제를 사용하면 Anthropic이 앱을 소유한 조직의 API 사용량에 대해 인보이스를 발행하며, 해당 조직은 선불 크레딧을 구매하지 않습니다. 이 경우에도 앱은 테스트 단계에서 시작하며, 테스트 사용자 및 지출 한도에 대한 규칙이 여전히 적용됩니다. 그 이후에는 세 가지가 다릅니다.
- 앱 게시: 앱 페이지에서 Publish app을 클릭하세요. 그런 다음 대화 상자에서 Publish app을 클릭하여 확인하세요. Anthropic은 앱을 검토하지 않으므로, 앱은 게시하는 즉시 라이브 상태가 됩니다.
- 홈페이지 및 도메인: 도메인을 증명하지 않으므로 대화 상자는 Prove your domain을 건너뜁니다. 게시하는 데 홈페이지가 필요하지 않으며, 앱 게시에 나와 있는 리디렉션 URI 규칙은 적용되지 않습니다. 클라이언트 인증은 여전히 먼저 설정해야 합니다.
- 라이브 앱 변경: Save changes를 클릭하거나 로고를 선택 또는 제거하면 Console이 변경 사항을 저장합니다. 도메인 증명이나 확인을 요청하지 않으며, 검토가 이어지지 않습니다.
이 페이지가 도움이 되었나요?