자율성이 3세대를 가른다 — 그리고 인증 우선순위가 곧 과금 경로다

AI 코딩 도구를 비교할 때 흔히 쓰는 축은 성능이다. 어느 모델이 더 정확한가, 어느 제품이 더 빠른가. 그런데 이 축으로는 도구를 바꿀 때 조직에서 실제로 벌어지는 일이 설명되지 않는다 — 정확도가 올랐다고 해서 권한 정책을 새로 써야 할 이유는 없기 때문이다.

설명력이 있는 축은 하나 더 있다. 자율성이다. 사람이 매 단계를 지시하느냐, 목표만 주고 중간 단계를 도구가 결정하느냐. 이 축이 바뀌는 순간 도구는 편집기에서 행위자가 되고, 행위자에게는 권한 경계가 필요해진다. 이 글은 그 축으로 세대를 가르고, 설치 단계에서 이미 조직 비용 사고가 잠복해 있다는 것까지 본다.

이 시리즈는 원 자료 기준(2026-04) 정리다. 제품 사양·수치·화면은 그 시점의 것이며, 아래 각주에 어떤 값이 시점에 묶여 있는지 항목별로 적었다.

용어 정리

이 시리즈 전체에서 반복되는 용어를 먼저 정리한다.

기본 개념

컨텍스트·모델

권한·거버넌스

연동·설치

세 축으로 갈라져 있다는 것이 설계의 핵심

Claude Code는 크게 ① 실행 계층(도구) · ② 통제 계층(권한·훅) · ③ 지식 계층(매뉴얼) 세 축으로 구성된다. 이 세 축이 분리돼 있다는 점이 이 도구의 설계 핵심이다.

분리가 왜 핵심인지는 관리 주체를 대입해 보면 드러난다. 세 축은 서로 다른 사람이 만지는 자산이다 — 실행 계층은 제품이 주는 것이고, 통제 계층은 보안·플랫폼 조직이 정하며, 지식 계층은 팀 리드가 쓴다. 축이 섞여 있었다면 권한 정책을 바꾸려고 매뉴얼을 고쳐야 하는 상황이 생긴다.

실행 흐름은 아래와 같다. 도구 호출 하나하나가 권한 게이트를 통과해야만 실제 시스템에 도달한다.

이 그림에서 리더가 봐야 할 지점은 두 곳이다.

• C~E 구간: 선언형 정책. JSON 한 파일로 조직 전체에 동일 규칙을 배포할 수 있다.
• F·H 구간: 절차형 검증. 시간·조건 등 패턴 문법으로 못 쓰는 규칙을 스크립트로 구현한다.

두 구간의 차이가 나중에 통제 설계 전체를 가른다. 선언형은 싸고 일괄 배포되지만 표현력이 낮고, 절차형은 무엇이든 쓸 수 있지만 스크립트를 유지보수해야 한다. settings.json과 훅 편이 이 두 구간을 각각 1차·2차 방어선으로 나눠 다룬다.

세대를 가르는 변수는 자율성 하나다

핵심 변수는 자율성이다. 1·2세대는 사람이 매 단계 지시했지만, 3세대는 최종 목표를 향한 중간 단계를 에이전트가 스스로 결정한다.

오른쪽 끝 열이 이 표의 결론이다.

세대가 바뀔 때 실제로 바뀌는 것은 도구의 성능이 아니라 사람의 직무다. 코드 작성자에서 검토자로, 검토자에서 목표 설정자로 옮겨간다. 도구 도입을 성능 개선 과제로 기안하면 이 열이 논의에서 빠지고, 그러면 "잘 쓰는 사람과 못 쓰는 사람"의 편차가 왜 벌어지는지 설명할 수 없게 된다. 편차는 숙련도가 아니라 직무 전환을 했는가에서 나온다.

에이전틱 코딩의 네 가지 특성

오른쪽 열 네 줄 중 아래 셋이 이 시리즈의 남은 세 편으로 그대로 이어진다. 권한 경계는 settings.json 편, 규칙 문서는 CLAUDE.md enforcement 편, 검증 지점 설계는 내장 도구와 지시 패턴 편이다. 첫 행(자율성)만 별도 편이 없는데, 지시 단위가 목표로 올라간다는 것은 나머지 셋의 전제이지 따로 푸는 숙제가 아니기 때문이다. 특성 하나하나가 숙제를 남긴다는 것이 3세대 도구 도입이 설치 가이드로 끝나지 않는 이유다.

도구 비교 — Copilot vs Cursor vs Claude Code

아래 비교는 원 자료 기준(2026-04) 서술이다. 제품은 빠르게 바뀌므로 각 항목은 그 시점의 스냅숏으로 읽어야 한다.

일곱 행 중 마지막 두 행이 조직 도입 심사에서 실제로 쟁점이 되는 자리다. 앞 다섯 행은 개인 생산성 이야기지만 연동과 감사 가능성은 보안 심사 항목이라서다.

터미널 네이티브가 단점이 아니라 강점인 이유

네 관점 중 앞의 셋은 같은 성질의 다른 얼굴이다. UI를 갖지 않았다는 것이 환경 독립성·투명성·자동화 친화성을 동시에 만든다. 마지막 행은 앞의 셋과 성격이 다르다 — 이점이 아니라 예상되는 반론에 대한 답이고, 실제로 터미널 도구 도입 논의에서 가장 먼저 나오는 우려가 여기다.

MCP — 공통 사원증

MCP는 에이전트가 외부 서비스에 붙는 방식을 표준화한 프로토콜이다. 커넥터를 서비스별·에이전트별로 중복 구현하지 않아도 된다는 것이 실무상 이점이다.

조직 운영 관점에서 중요한 것은 연동 자체가 아니라 MCP 서버 단위로 접근을 켜고 끌 수 있다는 점이다. 원 자료가 표준화의 이점을 둘로 든다는 데 주목할 만하다 — 앞 문단의 중복 구현 회피는 만드는 쪽의 이점이고, 이쪽은 통제 지점이 하나로 모인다는 운영 쪽의 이점이다. 서비스별로 커넥터를 따로 짰다면 차단 스위치도 커넥터 수만큼 흩어지지만, 표준 인터페이스를 통과하면 서버 목록 한 곳에서 켜고 끌 수 있다. 이것이 settings.json 편의 이중 잠금 원칙으로 이어진다.

시장 지표 (원 자료 인용 수치)

아래는 원 자료가 인용한 수치다. 출처와 기준일이 원 자료 시점(2026-04)이며 값마다 검증 주체가 제각각이라, 개별 숫자를 확정값으로 쓰기보다 "이런 지표로 비교된다"는 프레임으로 읽는 편이 맞다.

네 값의 성격이 서로 다르다는 점을 구분해 두는 편이 좋다. 첫 행은 벤치마크 점수, 둘째는 제품 사양, 셋째는 생태계 규모, 넷째는 기업 재무 지표다. 넷을 한 표에 모으면 "이 도구가 앞선다"는 하나의 주장처럼 읽히지만, 실제로는 서로 다른 네 가지를 재고 있고 검증 경로도 각각 다르다.

도입 3단계 — 설치·인증과 자격증명 경계

설치 자체는 명령 한 줄이지만, 인증 우선순위는 조직 비용 통제와 직결되므로 리더가 알아야 한다.

환경 요건

마지막 행이 조직 배포에서 실제로 발목을 잡는 자리다. 앞의 다섯은 개인이 확인하고 끝나지만 방화벽 정책은 개인이 못 고친다.

설치 방식 두 가지

# 방식 A — 네이티브 인스톨러 (원 자료 기준 2026-04 권장)
curl -fsSL https://claude.ai/install.sh | bash

# 방식 B — npm 글로벌 설치
npm install -g @anthropic-ai/claude-code

• sudo npm install -g 금지. 보안 위험이 있고, 이후 업데이트마다 권한이 꼬인다. 권한 오류 시에는 네이티브 인스톨러로 전환하거나 nvm으로 Node를 재설치한다.
• 설치 후에는 터미널을 닫고 새로 연다. PATH 변경이 반영되지 않아 command not found가 나는 사례가 가장 흔하다.

인증 — 우선순위가 곧 비용 통제

인증 소스에는 우선순위가 있고, 이 순서를 모르면 구독을 결제해놓고 API 크레딧이 소진되는 사고가 난다.

# 구독 사용자인데 인증 실패·잔액 부족 에러가 날 때 먼저 확인할 것
echo $ANTHROPIC_API_KEY     # 값이 있으면 API 키가 우선 사용되고 있다
unset ANTHROPIC_API_KEY     # 제거하면 구독 토큰이 동작한다

조직 관점 시사점

팀에 도구를 배포할 때 "설치 가이드"만 주면 안 된다.

개인 API 키가 환경 변수에 남아 있는 구성원이 있으면 조직 구독과 무관하게 개별 과금이 발생한다.

온보딩 체크리스트에 echo $ANTHROPIC_API_KEY 확인 절차를 넣는 것이 실질적인 비용 통제다.

이 사고가 조용히 일어난다는 점이 고약하다. 도구는 정상 동작하고 에러도 나지 않는다. 구성원 입장에서는 아무 이상이 없고, 청구서가 도착해야 드러난다. 환경 변수의 우선순위가 곧 과금 경로라는 사실이 설치 문서가 아니라 재무 문서에 적혀 있어야 할 내용인 이유다.

트러블슈팅 5종

다섯 중 둘(2·3행)만 npm 설치 방식에서 나오고 나머지 셋은 설치 방식과 무관하다. 앞 편의 실패 모드 3분류에 얹으면 1행이 PATH 미등록, 2·4행이 권한·인증에 해당한다 — 도구가 바뀌어도 분류가 재사용된다는 것이 여기서 확인된다. 3·5행은 그 셋에 들어가지 않는데, 런타임 버전과 실행 환경은 진단할 대상이 아니라 앞의 환경 요건 표로 돌아가야 하는 항목이기 때문이다.

여기까지가 "이 도구가 무엇이고 어떻게 켜는가"다. 자율성이 세대를 가르고, 자율성이 있으면 도구를 쓰며, 도구를 쓰면 권한이 필요하다.

그러면 그 도구가 정확히 무엇인지 봐야 한다. 다음 편에서 내장 도구 일곱 개를 하나씩 열고, 그 목록이 왜 그대로 공격 표면 목록이 되는지, 그리고 즉시 실행의 부작용을 막는 네 가지 지시 패턴을 본다.

인용 조건

• 이 시리즈의 제품 사양·수치는 원 자료 기준 2026-04이다. 단축키·설정 키·경로를 포함한 세부 사양은 버전에 따라 바뀐다.
• 본문의 SWE-bench 80.8% · MCP 커넥터 75+ · ARR $2.5B · 컨텍스트 1M 토큰은 원 자료가 2026년 4월 기준으로 인용한 값이다. 기준일과 함께 읽어야 하며, 기준일을 뗀 단정값으로 쓸 수 없다.
• Windows에서 WSL2 필수는 원 자료 기준(2026-04) 서술이며 제품 버전에 따라 달라질 수 있다.
• 본문에 등장하는 정책·설정 예시는 원 자료의 교육용 예시이며 특정 조직의 실제 운영 사례가 아니다.