솔로 개발자를 위한 Claude Code 권한 및 설정 워크플로우 분석

Claude Code는 코드베이스를 읽고 파일을 편집하며 명령을 실행하고 개발 도구와 연동되는 에이전트 코딩 도구입니다. 에이전트가 할 수 있는 일과 할 수 없는 일을 정확히 지정할 수 있도록 세분화된 권한을 지원합니다. 핵심은 권한 규칙을 강제하는 주체가 모델이 아니라 Claude Code라는 점입니다. 이는 프롬프트나 CLAUDE.md 파일의 지시가 에이전트가 무엇을 시도하도록 유도할 수는 있지만, Claude Code가 허용하는 범위를 변경하거나 확장하지는 못함을 의미합니다. 그래서 모델이 프롬프트를 따라 어떤 명령을 실행하려 해도, 설정에서 거부한 작업은 Claude Code가 막습니다. 솔로 개발자라면 지켜야 할 경계를 프롬프트가 아니라 권한 규칙으로 정해 두는 편이 안전합니다.

거부 규칙은 어느 범위에서든 우선한다

어느 한 범위에서라도 도구를 거부하면, 다른 범위나 명령줄 옵션으로는 그 도구를 다시 허용할 수 없습니다. 예를 들어 사용자 설정(~/.claude/settings.json)에서 거부한 명령은 프로젝트 설정에서 허용해도 실행되지 않습니다. 사용자 설정은 이 컴퓨터의 모든 프로젝트에 적용되므로, 어느 프로젝트에서도 실행되면 안 되는 명령은 사용자 설정의 거부 규칙에 두면 됩니다.

Manual 모드와 승인 워크플로우

Manual 모드에서는 파일 편집, 셸 명령 실행, 네트워크 접근 같은 대부분의 작업 전에 Claude Code가 멈추고 사용자에게 승인을 요청합니다. 보안에 민감한 작업을 할 때 유용한 모드입니다. 대부분의 작업은 실행 여부를 개발자가 직접 정합니다. 코드베이스의 핵심 부분을 고치거나 네트워크에 접근하는 작업이라면, 실행 전에 무엇을 하려는지 확인할 수 있어 실수를 줄이는 데 도움이 됩니다. 권한 모드는 CLI에서 Shift+Tab으로 바꿀 수 있습니다.

Claude Code의 설정은 동작을 바꾸는 JSON 키로, 시작할 때 쓸 모델, 묻지 않고 실행할 수 있는 작업, 읽을 수 없는 파일, 터미널에서의 모습, 조직이 강제하는 사항 등을 정합니다. 각 설정 소스에는 범위(scope)가 있어, 그 설정이 나에게만 적용되는지, 프로젝트의 모든 사람에게 적용되는지, 조직 전체에 적용되는지를 정합니다. Claude Code는 설정을 네 개의 파일에서 읽고, 조직은 관리형 설정을 따로 배포할 수도 있습니다. 동일한 키가 여러 곳에 존재할 경우, Claude Code는 해당 키를 설정한 가장 높은 수준의 값을 사용합니다. 우선순위는 높은 것부터 관리형 설정, 명령줄 옵션, 프로젝트 로컬 설정, 공유 프로젝트 설정, 사용자 설정 순입니다. 하지만 리스트 형식의 키, 예를 들어 permissions.allow와 같은 경우 예외적으로 동작합니다. 여러 파일에 동일한 리스트 키가 설정되면 Claude Code는 하나의 값만 선택하는 것이 아니라 각 파일의 항목을 결합하여 적용합니다. 이는 각 파일이 다른 파일의 허용 목록을 덮어쓰지 않고 추가할 수 있음을 의미하며, 모듈화된 권한 관리를 가능하게 합니다.

설정 관리의 실용적 적용

솔로 개발자는 프로젝트 전반에 공통으로 필요한 권한(예: git 명령 실행)은 프로젝트 레벨 설정 파일에 추가하고, 개인적으로만 필요한 특수한 도구 접근 권한은 개인 설정 파일에 추가할 수 있습니다. 리스트 결합 기능 덕분에 두 설정이 충돌 없이 통합되어 적용됩니다. /permissions 명령으로 모든 권한 규칙과 각 규칙이 들어 있는 settings.json 파일을 확인할 수 있습니다. 어떤 도구가 예상과 달리 막혔다면, 이 목록에서 그 도구를 거부한 규칙과 그 규칙이 있는 파일을 찾으면 됩니다.

Claude Code는 터미널에서 자연어 명령을 통해 코드베이스를 이해하고, 반복적인 작업을 실행하며, 복잡한 코드를 설명하고 git 워크플로우를 처리하여 코딩 속도를 높이는 도구입니다. 다만 어떤 작업을 묻지 않고 실행할지는 권한 모드와 권한 규칙이 정합니다. 혼자 쓰는 환경이라도 사용자 설정은 우선순위가 가장 낮습니다. 목록이 아닌 키를 프로젝트 설정이나 명령줄 옵션에서도 지정하면 그 값이 사용자 설정보다 우선하므로, 사용자 설정에 넣은 값이 적용되지 않으면 더 높은 수준에서 같은 키를 지정했는지 확인하십시오. 작업의 위험도에 따라 권한 모드를 골라 쓰고, 위험한 작업에서는 Manual 모드로 하나씩 승인하는 방식이 안전합니다. 또한 프롬프트만으로는 권한을 바꿀 수 없습니다. CLAUDE.md에 '모든 파일을 자유롭게 수정하라'고 지시해도, 설정에서 해당 파일 경로가 거부(deny)되어 있다면 Claude는 그 파일을 수정할 수 없습니다. 따라서 보안이 중요한 작업 전에는 반드시 /permissions 명령으로 현재 적용된 규칙을 확인하는 습관이 필요합니다.

분석 기간은 2026-10-05부터 2026-11-04까지입니다. Last30Days가 발견한 10개 항목 중 주제를 직접 다루고 HTTPS URL과 충분한 본문이 있으며 중복되지 않은 8개를 포함했습니다. 출처별 포함/발견 수는 reddit: 0/1, x: 7/8, youtube: 1/1입니다. 참여 수치가 확인된 항목은 1/8개이며, 나머지는 참여도를 추정하지 않았습니다. 이 절은 벤더 정책이 아니라 해당 기간에 관찰된 공개 게시물·영상 표본을 설명합니다. 표본은 시장 전체를 대표하지 않으며, 각 관찰은 아래 원문 링크로 확인할 수 있습니다.

• 2026-11-03 · x: Claude Code still asks before a few especially risky rm commands. you can now set CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1. (source)
• 2026-11-02 · youtube: How Claude Code permissions work: the four modes (Manual, Accept edits, Plan, Auto), allow rules that stop the prompts for commands you trust, and deny rules that block what must never run. The allow and deny rules from the video, in .claude/settings.json: { "permissions": { "allow": ["Bash(pnpm test *)", "Bash(pnpm run *)"], "deny": ["Bash(git push *)",… (source)
• 2026-10-30 · x: Claude Code 2.1.314 or later has a setting that makes Write, Edit and NotebookEdit refuse any path outside your working directories. (source)
• 2026-10-30 · x: New security setting in Claude Code 2.1.314 You can now prevent Claude from writing files outside your working directories, even in bypass permissions mode ... (source)
• 2026-10-29 · x: Older versions don't recognize it and skip the whole settings file, so the permissions and hooks you set up in it stop working too. Run claude --version first. (source)
• 2026-10-20 · x: Claude Code ALWAYS ask for your approval before executing these six sensitive Stripe tools, Settings for Claude Code , currency and recipient. (source)
• 2026-10-18 · x: Claude Code asking permission before every file edit is safer. Middle ground works for me: edits allowed, bash commands ask first. Permissions control what ... (source)
• 2026-10-15 · x: Armor makes Claude Code's auto permissions mode compatible with any model. For instant setup, run Claude Code and your favorite model with Ori: $ ori claude ... (source)