메인 콘텐츠로 건너뛰기

Claude 코드 FAQ

오늘 업데이트함

이 문서는 인증, 통합, 구성 등과 관련된 Claude Code에 대한 자주 묻는 질문들을 모은 것입니다. Claude Code에 대해 더 알아보고 싶으시다면 Claude Docs를 참조하세요: Claude Code 개요.

Claude Code에 대해 단일 로그인(SSO)을 설정하려면 어떻게 해야 하나요?

Claude Console 조직에 대해 단일 로그인을 설정하는 경우 자세한 지침이 여기에 있습니다: Claude Console에서 단일 로그인 설정. Enterprise 플랜으로 Claude Code를 사용하는 경우 SSO 설정 지침은 이 문서를 참조하세요: Enterprise 플랜에서 단일 로그인(SSO) 설정.

Claude Code에서 전체 조직에 걸쳐 Opus 모델 액세스를 비활성화할 수 있는 방법이 있나요?

Claude Console 사용자인 경우 Console 조직의 속도 제한을 통해 이를 구성할 수 있습니다. Bedrock 또는 Vertex를 사용하는 경우 Vertex/Bedrock 프로젝트 설정에서 Opus 속도 제한을 0으로 설정하세요. Vertex에서 비활성화되어 있어도 사용자가 Claude Code에서 모델을 전환할 수 있으므로 속도 제한이 가장 효과적인 방법입니다.

Claude Code는 Microsoft Visual Studio IDE 통합(VS Code 아님)을 지원하나요?

현재 Visual Studio 2022 통합은 없습니다. Claude Code는 현재 VS Code, Cursor(및 기타 VS Code 포크), Intellij, Pycharm(및 기타 Jetbrains IDE)을 지원합니다.

Claude Code로 PR 검토 자동화를 구현하려면 어떻게 해야 하나요?

아직 턴키 PR 검토자 솔루션은 없지만 자동화된 검토를 위해 Claude Code GitHub Actions 통합을 사용할 수 있습니다. 현재로서는 보안 검토 작업을 템플릿으로 사용하여 일반 PR 검토를 위해 사용자 정의할 수 있습니다. 이는 또한 Claude Code SDK의 좋은 사용 사례입니다.

"Claude Max 또는 Pro가 Claude Code에 연결하기 위해 필요합니다"라는 오류 메시지가 표시되지만 조직의 Team 또는 Enterprise 플랜을 통해 액세스할 수 있어야 합니다. 어떻게 문제를 해결할 수 있나요?

이는 Claude Code 설정 화면에서 잘못된 로그인 방법을 선택했음을 나타냅니다. /login을 다시 실행하고 기본 업무 이메일 주소와 연결된 계정을 선택해 보세요. 여전히 연결할 수 없으면 Team 또는 Enterprise 계정을 사용하여 Claude Code에 액세스하는 데 문제가 있으신가요?를 참조하세요.

Bedrock/Vertex API 키로 Claude Code를 사용할 때 Anthropic에 어떤 데이터가 전송되나요?

Bedrock/Vertex로 구성되고 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이 설정된 경우 필수 텔레메트리만 전송됩니다. 모든 모델 API 요청은 Bedrock/Vertex 엔드포인트로 직접 이동합니다. 전체 세부 정보는 데이터 흐름 문서를 검토하세요.

비밀 키/액세스 키를 노출하지 않고 Bedrock/Vertex를 통해 Claude Code에 액세스할 수 있는 방법이 있나요?

예. BedrockVertex에 대한 설정 가이드에서 이를 활성화하는 방법을 보여줍니다. 예를 들어 Bedrock의 경우 필요한 구성을 추가하고 Bedrock으로 Claude Code를 실행하기 전에 `aws configure`를 실행하여 AWS CLI를 구성할 수 있습니다. 또는 AWS의 새로운 기능인 Bedrock API 키를 사용할 수 있으며, 이는 전체 AWS 자격 증명이 필요하지 않은 Bedrock 사용을 위한 API 키를 활성화합니다.

1M 컨텍스트 윈도우를 Claude Code에서 사용할 수 있으며, 사용자에게 더 높은 가격에 대해 경고를 받을까요?

긴 컨텍스트 지원은 현재 Max 20x 플랜의 일부 Claude Code 사용자로만 제한되어 있으므로 소수의 사용자만 사용할 수 있습니다. 1M 컨텍스트 윈도우는 API를 통해 Claude에 액세스하는 사용자를 포함하여 모든 Claude Code 사용자에게 아직 일반적으로 사용할 수 없습니다.

조직 전체에 걸쳐 사용자 정의 환경 변수 및 권한으로 Claude Code를 배포하려면 어떻게 해야 하나요?

Claude Code를 실행하기 전에 환경 변수를 설정하는 래퍼 스크립트를 만드세요. 권한의 경우 허용/거부 목록이 있는 .claude/settings.json 파일을 사용하세요. 와일드카드 패턴(*)이 항상 예상대로 일치하지는 않으므로 권한을 철저히 테스트하세요. Enterprise 팀은 일관된 구성을 위해 표준화된 Claude.md 파일을 주입하는 경우가 많습니다.

Claude Code에 공개 코드 필터링 또는 속성 기능이 로드맵에 있나요?

아니요, 공개 코드 필터링 및 속성 기능은 현재 로드맵에 없습니다. 일부 고객은 코드 스캔을 위해 BlackDuck을 사용하지만 비용 및 거짓 양성에 대한 피드백이 엇갈렸습니다. 이것이 Claude Code를 더 많은 사용자로 확장하기 위한 차단 요소임을 알고 있으며 솔루션을 모색 중입니다.

Claude Code SDK 및 GitHub Actions에서 서브에이전트를 사용할 수 있나요?

서브에이전트는 Claude Code SDK를 통해 사용할 수 있습니다. 아직 GitHub Actions에 통합되지 않았지만 이를 고려 중입니다. UX는 복잡성을 관리하기 위해 3개 이상의 서브에이전트가 병렬로 실행될 때 출력을 축소합니다.

서브에이전트를 특정 MCP 도구를 사용하도록 구성할 수 있나요?

예, 서브에이전트를 만들 때 구성의 `tools` 필드를 사용하여 액세스할 수 있는 도구를 지정할 수 있습니다. 서브에이전트 구성 파일에서 도구 필드를 생략하여 메인 스레드의 모든 도구를 상속하거나 더 세분화된 제어를 위해 개별 도구를 쉼표로 구분된 목록으로 지정할 수 있습니다. Claude Docs에서 자세히 알아보세요: 서브에이전트 - 사용 가능한 도구.

Claude Code 비용을 관리하려면 어떻게 해야 하나요, 특히 자동화된 워크플로우의 경우?

보안 검토와 같은 자동화된 워크플로우의 경우 비용 절감을 위해 claude --model <alias|name> 구성 옵션을 사용하여 Opus에서 Sonnet으로 전환하세요. 콘솔 대시보드를 통해 사용량을 모니터링하고 적절한 속도 제한을 설정할 수도 있습니다. 워크스페이스를 사용하여 다양한 사용자 그룹에 대해 더 세분화된 지출 제한을 설정할 수 있습니다. 워크스페이스에 대해 자세히 알아보세요: Claude Console에서 워크스페이스 생성 및 관리. 또한 콘솔에서 API 키당 지출을 볼 수 있습니다. 자세한 내용은 이 문서를 참조하세요: Claude Console의 비용 및 사용량 보고.

Claude Code는 LiteLLM과 같은 기업 프록시를 통해 작동할 수 있나요?

예, Claude Code는 Anthropic API 사양을 지원하는 한 기업 프록시 구성을 지원합니다. Claude Docs의 프록시 설정 지침을 따르세요: 프록시 구성. 일반적인 문제는 제한된 환경의 포트 제한에서 발생합니다.

Console 계정을 사용할 때 Claude Code에 사용자를 추가하려면 어떻게 해야 하나요?

Claude Code User 또는 Developer 역할을 가진 Console 조직에 사용자를 직접 추가하면 됩니다. 그러면 사용자가 Claude Code 내에서 /login을 실행하고 의도한 Console 계정을 선택합니다. Claude Code 워크스페이스에서 API 키를 수동으로 만들려고 하지 마세요.

Claude.md 파일 이상의 팀 기반 메모리 또는 지식 공유가 있나요?

현재 Claude.md 파일이 주요 메커니즘입니다. IT 팀은 조직 전체 구성을 위해 표준화된 Claude.md 파일을 모든 머신의 .claude 디렉토리에 주입할 수 있습니다. 더 고급 팀 메모리 기능이 탐색 중이지만 아직 사용할 수 없습니다.

Claude Code에서 권한은 어떻게 작동하며, 내 허용 목록이 존중되지 않는 이유는 무엇인가요?

권한은 .claude/settings.json 또는 settings.local.json의 패턴 매칭을 사용합니다. 와일드카드 구문은 까다로울 수 있습니다. "Bash(atlassian-api:*)"는 작동해야 하지만 정확한 명령 매칭이 필요할 수 있습니다. "예, 유사한 명령에 대해 다시 묻지 마세요"를 사용하여 권한을 점진적으로 구축하세요. 전역(~/.claude/settings.json) 및 로컬 설정 파일을 모두 확인하세요.

Claude Code는 전체 코드베이스를 인덱싱하거나 벡터 데이터베이스를 사용하여 코드베이스에 대한 정보를 저장하나요?

아니요. Claude Code는 시스템 프롬프트 및 코드베이스를 탐색하는 데 사용할 수 있는 일련의 도구에 액세스할 수 있습니다. 예를 들어 Claude Code가 코드베이스에 대해 무언가를 이해해야 하는 경우 검색 도구를 사용하여 코드베이스를 검색하고 명령에 따라 파일을 읽습니다. 우리는 이것이 전체 코드베이스 인덱싱보다 더 효과적이고 유연하다는 것을 발견했습니다. Claude Code는 필요한 컨텍스트를 즉시 수집하기 위해 코드베이스를 어떻게 살펴볼지 아는 데 정말 능숙합니다!

Claude Code는 CI/CD, 버전 제어 및 관찰성 플랫폼과 통합될 수 있나요?

예, Claude Code는 CI/CD를 위해 GitHub Actions와 통합되고 git 작업을 지원하며 MCP 서버를 통해 다양한 플랫폼에 연결할 수 있습니다. 자세한 내용은 Claude Docs를 참조하세요:

GitHub Actions에서 "워크플로우 검증 실패" 오류가 표시되는 이유는 무엇인가요?

이는 일반적으로 재사용 가능한 워크플로우에서 발생합니다. 워크플로우 구문이 올바른지 확인하고 모든 필수 매개변수가 전달되었는지 확인하세요. 오류가 계속되면 워크플로우 구성과 함께 여기에 문제를 제출하세요: github.com/anthropics/claude-code-action.

답변이 도움되었나요?