전체 글 검색 결과

해당 글 258건

Claude ant apply 사용법: 설정 파일과 claude-lock.json 관리

에이전트 설정을 저장소에서 관리하려면 설정 파일과 원격 리소스를 연결하는 기록이 필요합니다. Claude API의 ant apply는 파일을 읽어 리소스를 생성·갱신하고, claude-lock.json으로 다음 실행에서도 같은 대상을 찾습니다.이 글은 API 리소스 관리용 CLI인 ant를 다룹니다. Claude Code의 로컬 지침 파일을 설정하는 절차와는 구분해야 합니다.먼저 구분할 용어용어이 글에서의 의미리소스API에서 생성·관리하는 에이전트 등의 대상frontmatterMarkdown 파일 맨 위의 --- 사이에 넣는 설정잠금 파일파일과 원격 리소스 ID의 연결 등을 기록하는 claude-lock.json1. CLI 설치와 인증Anthropic의 CLI quickstart는 macOS Homebr..
AI 2026. 10. 30. 09:30

Claude Models API 사용법: thinking 서버 도구 지원 여부 확인하기

Claude API에서 모델을 바꿀 때는 기존 thinking·도구 설정을 그대로 보내도 되는지 먼저 확인해야 합니다. GET /v1/models/{model_id}로 모델 정보를 가져오면 capabilities에서 설정별 지원 여부를 읽을 수 있습니다. 다만 이 값만으로 요청 성공까지 보장되지는 않습니다.주요 용어용어이 글에서의 의미Models API모델 정보와 기능 지원값을 조회하는 APIcapabilities모델별 기능 지원 정보를 담는 응답 객체supported해당 기능이나 설정의 수용 여부를 나타내는 값1. 사용할 모델을 단건 조회하기Anthropic의 Get a Model 문서는 경로에 모델 ID 또는 별칭을 넣도록 안내합니다. 별칭을 사용했다면 응답의 id도 함께 보관해 실제로 어떤 모델 정..
AI 2026. 10. 30. 07:17

Claude Enterprise Inference hooks 설정: 보안 서버로 프롬프트 허용·차단하기

Claude Enterprise의 Inference hooks는 적용 대상 요청을 추론 전에 조직이 지정한 보안 서버로 보내 허용·차단 판정을 받는 기능입니다. 집행 상태에서 거부된 프롬프트는 모델에 도달하지 않습니다. 이 글은 Enterprise 관리자와 연동 개발자를 위한 공식 문서 기반 설정 안내입니다.먼저 구분할 용어용어이 글에서의 의미Inference hooks추론 전 대화 내용을 외부 보안 서버에 보내 판정을 받는 기능엔드포인트판정 요청을 받는 보안 서버의 HTTPS 주소Shadow mode서버 판정을 받되 요청을 차단하지 않는 관찰 모드서명 비밀값수신 요청의 서명을 검증하는 데 사용하는 비밀값Claude의 Inference hooks 개요에 따르면 Claude Platform API 조직은 ..
AI 2026. 10. 29. 13:39

Claude Tag API로 Slack 채널 설정 관리하기: Enterprise 권한부터 설정 상속 조회까지

Slack 채널에서 Claude 설정이 예상과 다르게 적용된다면, 채널에 저장된 값과 상위 설정에서 물려받은 값을 구분해야 합니다. Claude Tag API는 Claude Enterprise 조직의 Slack 설정을 조회·변경하고, 적용된 설정의 출처를 보여줍니다. Claude Console 조직이나 Console에서 만든 키로는 사용할 수 없습니다.이 글은 이미 Claude Tag를 설정하고 Slack을 연결한 조직에서, 채널 하나의 설정을 찾고 변경한 뒤 상속 결과를 확인하는 흐름을 다룹니다.이 글에서 사용하는 주요 용어 정의용어정의Admin API 키조직 관리 API를 호출하는 키로, Claude Tag용 권한 범위를 선택해야 합니다.저장값해당 채널이나 워크스페이스에 직접 지정한 설정입니다.상속 ..
AI 2026. 10. 29. 08:39

Claude API web fetch 도메인 제한: 조직 정책과 요청별 허용 목록 설정

Claude API가 지정한 사이트만 읽도록 하려면 Console의 조직 정책과 요청의 allowed_domains를 함께 점검해야 합니다. 조직 관리자는 web fetch 사용 여부와 도메인 정책을 정하고, 개발자는 Messages API 요청의 도구 객체에 작업별 허용 목록을 넣습니다.이 글에서 사용하는 주요 용어 정의용어의미web fetch지정한 웹페이지의 내용을 가져오는 서버 도구조직 정책Claude Console에서 관리자가 설정하는 web fetch 사용·도메인 제한allowed_domains도구가 접근할 수 있는 호스트를 지정하는 허용 목록blocked_domains접근을 막을 호스트를 지정하는 차단 목록1. Console에서 조직 정책 설정하기Anthropic의 2026년 10월 20일 릴..
AI 2026. 10. 28. 12:00

Claude API 사용자 프로필 설정: 고객별 요청 연결과 제한 상태 조회

여러 고객의 요청을 같은 Claude API 조직에서 보내는 서비스라면 고객 프로필 생성 → ID 저장 → 요청에 연결 → 제한 상태 조회 순서로 구성하면 됩니다. Anthropic의 사용자 프로필은 각 요청이 어느 고객의 것인지 알려 주며, 고객 단위로 안전 조치를 적용할 수 있게 합니다.여기서 제한은 안전 정책에 따른 조치를 뜻합니다. 요금 상한이나 토큰 사용량을 설정하는 기능과는 다릅니다. 이 글은 직접 Claude API를 호출하는 서비스를 대상으로 합니다.주요 용어용어의미user_profiles고객 식별 정보를 등록·조회하는 API 리소스uprof_ ID프로필 생성 응답으로 받는 고유 식별자enforcement_statusAnthropic이 정한 안전 조치 상태enforcement_actions..
AI 2026. 10. 28. 07:20

Google Cloud에서 Claude API 연결하기: IAM 인증부터 첫 요청까지

Google Cloud에서 Anthropic 관리형 Claude API를 호출하려면 Marketplace 구독과 서비스 활성화, IAM 호출 권한, 로컬 인증 설정이 필요합니다. 이 글은 Windows PowerShell과 Python SDK로 첫 메시지를 보내는 절차를 다룹니다.Google 관리형에서 사용하는 AnthropicVertex와는 연결 방식이 다릅니다. 여기서는 AnthropicGoogleCloud 클라이언트를 사용합니다.먼저 구분할 용어인증과 권한을 나누어 이해하면 로그인 후 발생하는 오류를 좁히기 쉽습니다.용어이 글에서의 의미IAMGoogle Cloud에서 호출 주체의 접근 권한을 관리하는 체계ADCSDK가 사용할 Google 인증 정보를 찾는 방식WorkspaceClaude 요청의 대상..
AI 2026. 10. 27. 18:25

Claude API 2026-10-21 마이그레이션: SDK 업데이트와 요청 형식 수정 순서

Claude API를 2026-10-21 버전으로 옮길 때는 SDK 업데이트와 요청 코드 수정을 함께 배포해야 합니다. 새 버전에서는 기존에 보내던 temperature만 남아 있어도 400 오류가 납니다.Anthropic의 마이그레이션 가이드는 버전 전환 준비 → 영향받는 코드 수정 → 새 버전 테스트 순서를 안내합니다. 여기서는 Python·TypeScript 기반 Messages API 연동을 중심으로 정리합니다. Claude Code 업데이트와는 별개입니다.먼저 구분할 용어용어이 글에서의 의미API 버전서버가 요청과 응답을 처리하는 규칙의 버전입니다.SDK 버전프로젝트에 설치하는 클라이언트 라이브러리의 버전입니다.anthropic-version직접 HTTP 호출에서 API 버전을 지정하는 헤더입니..
AI 2026. 10. 27. 07:24

Claude Code /auto-mode-setup 사용법: 프로젝트에 맞는 자동 권한 설정

/auto-mode-setup은 현재 프로젝트와 최근 세션을 분석해 자동 권한 판단에 쓸 환경 설정을 제안하는 명령입니다. Anthropic 공식 문서에 따르면 초안을 수락하면 사용자 설정인 ~/.claude/settings.json에 저장됩니다. 프로젝트에 맞춰 만들지만, 그 프로젝트에서만 적용되는 설정은 아니라는 점부터 기억하면 됩니다.먼저 구분할 용어설정 생성과 권한 모드 전환은 별도 작업입니다.용어의미auto 모드별도 분류 모델이 행동을 검토하는 권한 모드/auto-mode-setup프로젝트 정보를 바탕으로 설정 초안을 만드는 명령autoMode.environment프로젝트와 최근 세션을 바탕으로 제안하는 환경 설정설정하는 순서아래 명령은 공식 문서 기반의 미실행 예제입니다. 실제 계정에서의 실행..
AI 2026. 10. 27. 07:23

Claude Managed Agents 동적 워크플로 사용법: 병렬 분석부터 결과 통합까지

Claude Managed Agents의 동적 워크플로(dynamic workflows)는 여러 에이전트를 단계 안에서 병렬로 실행하고, 반환값을 다음 단계에 넘겨 합치는 기능입니다. Anthropic은 2026년 10월 9일 이 기능을 베타로 출시했습니다.문서 묶음을 나눠 분석한 뒤 하나의 보고서로 합치는 작업에 적용할 수 있습니다. 여기서는 Claude Platform API의 설정과 요청 방법, 완료 확인 조건을 다룹니다. Claude 앱이나 Claude Code의 설정법과는 구분해야 합니다.이 글에서 사용하는 주요 용어 정의아래 구분을 알면 설정 대상과 실행 기록을 혼동하지 않습니다.용어정의agent모델·지침·도구를 담은 에이전트 설정입니다.session에이전트와 실행 환경을 연결해 작업하는 단위..
AI 2026. 10. 26. 12:19