Claude Code 설정

Claude Code는 사용자의 요구사항에 맞게 동작을 구성할 수 있는 다양한 설정을 제공합니다. 대화형 REPL을 사용할 때 /config 명령을 실행하여 Claude Code를 구성할 수 있습니다.

​

설정 파일

settings.json 파일은 계층적 설정을 통해 Claude Code를 구성하는 공식 메커니즘입니다:

• 사용자 설정은 ~/.claude/settings.json에 정의되며 모든 프로젝트에 적용됩니다.
• 프로젝트 설정은 프로젝트 디렉토리에 저장됩니다:
  • .claude/settings.json은 소스 제어에 체크인되어 팀과 공유되는 설정용
  • .claude/settings.local.json은 체크인되지 않는 설정으로, 개인 선호도와 실험에 유용합니다. Claude Code는 생성될 때 git이 .claude/settings.local.json을 무시하도록 구성합니다.
• Claude Code의 엔터프라이즈 배포의 경우, 엔터프라이즈 관리 정책 설정도 지원합니다. 이는 사용자 및 프로젝트 설정보다 우선합니다. 시스템 관리자는 macOS의 /Library/Application Support/ClaudeCode/policies.json과 Linux 및 WSL을 통한 Windows의 /etc/claude-code/policies.json에 정책을 배포할 수 있습니다.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

사용 가능한 설정

settings.json은 여러 옵션을 지원합니다:

​

설정 우선순위

설정은 우선순위 순서로 적용됩니다:

1. 엔터프라이즈 정책 (IAM 문서 참조)
2. 명령줄 인수
3. 로컬 프로젝트 설정
4. 공유 프로젝트 설정
5. 사용자 설정

​

환경 변수

Claude Code는 동작을 제어하기 위해 다음 환경 변수를 지원합니다:

​

구성 옵션

전역 구성을 settings.json으로 마이그레이션하는 과정에 있습니다.

claude config는 settings.json을 위해 더 이상 사용되지 않을 예정입니다

구성을 관리하려면 다음 명령을 사용하세요:

• 설정 목록: claude config list
• 설정 보기: claude config get <key>
• 설정 변경: claude config set <key> <value>
• 설정에 추가 (목록용): claude config add <key> <value>
• 설정에서 제거 (목록용): claude config remove <key> <value>

기본적으로 config는 프로젝트 구성을 변경합니다. 전역 구성을 관리하려면 --global (또는 -g) 플래그를 사용하세요.

​

전역 구성

전역 구성을 설정하려면 claude config set -g <key> <value>를 사용하세요:

​

Claude가 사용할 수 있는 도구

Claude Code는 코드베이스를 이해하고 수정하는 데 도움이 되는 강력한 도구 세트에 액세스할 수 있습니다:

권한 규칙은 /allowed-tools를 사용하거나 권한 설정에서 구성할 수 있습니다.

​

참고 항목

• 신원 및 액세스 관리 - Claude Code의 권한 시스템에 대해 알아보기
• IAM 및 액세스 제어 - 엔터프라이즈 정책 관리
• 문제 해결 - 일반적인 구성 문제에 대한 해결책