snow · 2026.5.9 11:48 · 조회 1
권한 설정 (settings.json)
설정 파일 위치
Claude Code는 계층적 설정 파일을 사용합니다.
| 파일 | 범위 | 설명 |
|---|---|---|
~/.claude/settings.json | 글로벌 | 모든 프로젝트에 적용 |
{project}/.claude/settings.json | 프로젝트 | 해당 프로젝트에만 적용 |
{project}/.claude/settings.local.json | 로컬 | Git에 커밋하지 않는 개인 설정 |
프로젝트 설정이 글로벌 설정을 오버라이드합니다.
권한(Permissions) 설정
Claude Code가 사용할 수 있는 도구를 명시적으로 허용하거나 차단합니다.
1{2 "permissions": {3 "allow": [4 "Bash(git *)",5 "Bash(npm run *)",6 "Bash(npm test)",7 "Read(**)",8 "Edit(**)",9 "Write(**)"10 ],11 "deny": [12 "Bash(rm -rf *)",13 "Bash(curl *)",14 "Bash(wget *)"15 ]16 }17}허용 패턴 예시
1"allow": [2 "Bash(git *)", // 모든 git 명령3 "Bash(npm run build)", // 특정 명령만4 "Read(src/**)", // src 하위 읽기만5 "Edit(src/**)", // src 하위 편집만6 "mcp__github__*" // GitHub MCP 모든 도구7]승인 모드(Permission Mode)
| 모드 | 설명 | 적합한 환경 |
|---|---|---|
default | 위험한 작업은 승인 요청 | 일반 개발 |
acceptEdits | 파일 편집 자동 승인, 명령 승인 요청 | 신뢰된 프로젝트 |
auto | 모든 작업 자동 승인 | 자동화 스크립트 |
bypassPermissions | 모든 권한 우회 | CI/CD (주의) |
1# 모드 지정 실행2claude --permission-mode auto3claude --permission-mode acceptEdits모델 설정
1{2 "model": "claude-sonnet-4-6",3 "smallModel": "claude-haiku-4-5"4}| 설정 | 설명 |
|---|---|
model | 주 작업에 사용할 모델 |
smallModel | 간단한 요약 등 경량 작업에 사용할 모델 |
MCP 서버 설정
1{2 "mcpServers": {3 "github": {4 "command": "npx",5 "args": ["-y", "@modelcontextprotocol/server-github"],6 "env": {7 "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."8 }9 }10 }11}환경 변수 주입
settings.json에서 환경 변수를 정의하면 Claude Code 실행 시 자동으로 적용됩니다.
1{2 "env": {3 "NODE_ENV": "development",4 "LOG_LEVEL": "debug"5 }6}팀 공통 설정 예시
1{2 "model": "claude-sonnet-4-6",3 "permissions": {4 "allow": [5 "Bash(git *)",6 "Bash(npm *)",7 "Bash(npx *)",8 "Read(**)",9 "Edit(src/**)",10 "Write(src/**)"11 ],12 "deny": [13 "Bash(rm -rf *)",14 "Bash(sudo *)",15 "Bash(curl * | bash *)"16 ]17 }18}댓글
아직 댓글이 없습니다.
댓글을 작성하려면 로그인이 필요합니다.