Claude Code 설치 후 처음 설정해야 할 항목

이런 상황일 때

설치는 끝났는데 설정할 것이 많아 보입니다. 권한을 물어볼 때마다 눌러 주는 게 맞는지, 규칙 파일은 꼭 만들어야 하는지, 무엇부터 손대야 할지 막막합니다.

한 줄 결론

순서는 셋입니다 — 로그인 방식(요금 방식) → 권한 이해 → 프로젝트 규칙 파일. 모델 선택 같은 나머지는 그다음이어도 늦지 않습니다. 그리고 첫 실행은 반드시 git 저장소 안에서 하세요.

핵심 개념

로그인 방식이 곧 요금 방식이다

구독 계정으로 로그인하면 구독 사용량에서, API 키를 넣으면 종량 요금에서 나갑니다. 어느 쪽이 맞는지는 쓰는 방식에 달렸습니다 — 판단 기준은 구독·API 차이 글에 따로 정리했습니다.

권한 확인은 성가심이 아니라 안전장치다

파일을 고치거나 명령을 돌리기 전에 물어보는 것이 기본입니다. 처음부터 끄지 마세요. 무엇을 물어보는지 며칠 지켜본 뒤에, 자주 쓰는 안전한 것만 좁혀서 허용하는 순서가 맞습니다.

CLAUDE.md 는 매번 실리는 프로젝트 기억이다

프로젝트 폴더의 CLAUDE.md 는 세션마다 자동으로 읽힙니다. 빌드·테스트 명령, 건드리면 안 되는 폴더 같은 것을 한 번 적어 두면 매번 다시 말할 필요가 없습니다.

어디서 시작하느냐가 절반이다

프로젝트 폴더에서, 그것도 git 저장소 안에서 시작해야 합니다. git 이 있어야 도구가 만든 변경을 나중에 구분하고 되돌릴 수 있습니다.

이런 분에게 해당됩니다

• Claude Code 를 방금 설치한 분
• 권한 질문에 매번 눌러 주는 게 맞는지 궁금한 분
• 규칙 파일 이야기는 들었는데 아직 안 만든 분

확인해야 할 항목

• 터미널에서 claude 명령이 실행되는가
• 로그인한 계정이 의도한 요금 방식(구독/API)인가
• 작업 폴더가 git 저장소인가
• CLAUDE.md 가 있는가
• 권한 확인이 기본값(물어보기)으로 켜져 있는가

잘못 이해하기 쉬운 부분

안전한 행동 순서

1. 공식 문서의 설치 방법으로 설치하고, 버전 확인으로 설치를 확인합니다 (아래 명령).
2. claude 를 처음 실행해 로그인합니다 — 구독이면 계정 로그인, 종량이면 API 키입니다.
3. 작업할 프로젝트 폴더로 가서 git 저장소인지 확인합니다.
4. CLAUDE.md 를 만들어 빌드·테스트 명령과 건드리면 안 되는 것들을 적습니다.
5. 권한 확인은 기본값으로 며칠 씁니다. 무엇을 자주 물어보는지 보입니다.
6. 그다음에 자주 쓰는 안전한 명령만 좁혀서 허용합니다.

설치와 확인 (Windows·macOS·Linux 공통)

npm install -g @anthropic-ai/claude-code
claude --version

Node.js 가 필요합니다. 다른 설치 방법은 공식 문서에 있습니다. 확인 실행 결과: 2.1.223 (Claude Code) · 확인: 2026-08-07 · 개발 PC (Windows 11, npx 로 동일 패키지 실행 확인)

확인 체크리스트

• 버전 확인 명령이 답한다
• 로그인 계정·요금 방식을 확인했다
• git 저장소 안에서 시작했다
• CLAUDE.md 에 빌드·테스트 명령을 적었다
• 권한 확인을 끄지 않았다

관련 도구와 버전 페이지

• Claude Code 버전 추적 — 아직 제공하지 않습니다
  이 사이트는 아직 Claude Code 를 추적하지 않습니다. 새 버전·변경 사항은 공식 문서와 릴리스 노트를 직접 확인하셔야 합니다.

자주 묻는 것

회사 코드인데 코드가 밖으로 나가는 것 아닌가요?

처리를 위해 코드가 모델로 전송됩니다. 데이터 취급 정책은 공식 문서에 있고, 회사 코드라면 회사의 AI 도구 정책을 먼저 확인하는 것이 순서입니다.

구독과 API 중 무엇으로 로그인해야 하나요?

매일 직접 쓰는 개발 보조라면 구독이 예측 가능하고, 스크립트·CI 처럼 자동화가 부르는 자리라면 API 입니다. 자세한 기준은 구독·API 차이 글에 있습니다.

권한 질문이 너무 잦습니다.

같은 종류를 반복해서 물으면 그 종류만 세션 또는 프로젝트 단위로 허용하세요. 전부 끄는 것과 좁혀서 허용하는 것은 다릅니다.