한줄 요약
프로젝트 폴더에서 claude를 실행하고 자연어로 지시합니다. 기본 권한 모드는 파일 편집과 명령 실행 전에 확인하며, Plan·acceptEdits 등 다른 모드는 승인 방식이 달라집니다. 작업 전 Git 상태를 확인하고 완료 후 diff와 테스트 결과를 직접 검토하세요.
1. 기본 정보
- 시작
- 프로젝트 폴더에서 claude 실행
- 일회성 작업
- claude "작업 내용"
- 이전 대화 이어서
- claude -c
- 도움말
- /help
- 종료
- /exit 또는 Ctrl+D
2. 첫 번째 작업까지
-
1. 프로젝트 폴더 이동
터미널에서 작업할 프로젝트 폴더로 이동합니다.
cd 폴더경로를 사용하거나, VS Code·JetBrains IDE에서 내장 터미널을 열면 자동으로 프로젝트 폴더에서 시작됩니다. -
2. claude 실행
claude를 입력하고 Enter를 누릅니다. Claude Code가 현재 폴더의 파일 구조를 파악하고 프롬프트가 나타납니다. -
3. 코드베이스 파악
처음엔 프로젝트 구조를 파악하도록 질문하세요. "이 프로젝트가 뭘 하는 건지 설명해줘" 또는 "폴더 구조를 설명해줘"처럼 물으면 됩니다.
-
4. 작업 지시
자연어로 원하는 작업을 설명합니다. "로그인 페이지에 이메일 유효성 검사를 추가해줘"처럼 구체적으로 설명할수록 결과가 좋습니다.
-
5. 권한 모드 선택
기본 모드는 파일 편집과 셸 명령 전에 승인을 요청합니다. 조사만 먼저 하려면 Plan, 편집을 연속 허용하려면 acceptEdits를 선택할 수 있습니다. 모드마다 허용 범위가 다르므로 화면의 현재 모드를 확인하세요.
-
6. Git 작업
Git 조회·브랜치·커밋도 말로 요청할 수 있습니다. 커밋이나 원격 작업은 결과가 남으므로 실행 전에 대상 파일과 브랜치를 확인하고, 완료 후
git diff와 테스트 결과를 검토하세요.
3. 더 잘 쓰는 법
Claude Code는 대화하듯 사용할 수 있습니다. 작업이 복잡하면 단계로 나눠 지시하는 것이 효과적입니다.
- 구체적으로 설명하기 — "버그 고쳐줘" 보다 "로그인 후 빈 화면이 나타나는 버그를 고쳐줘"처럼
- 먼저 파악하게 하기 — 수정 전 "데이터베이스 스키마를 분석해줘"처럼 컨텍스트를 먼저 쌓기
- 이전 대화 이어서 — 같은 프로젝트에서 다시 시작할 때
claude -c로 이전 맥락 유지
4. VS Code·JetBrains에서 사용하기
터미널 대신 IDE 안에서 Claude Code를 사용할 수도 있습니다. VS Code는 Claude Code 확장을 설치하면 에디터 안에서 바로 사용할 수 있습니다. JetBrains IDE(IntelliJ, PyCharm 등)도 플러그인으로 지원합니다.
5. 웹에서 사용하기
Claude Code on the web은 브라우저의 claude.ai/code에서 Anthropic 관리 클라우드 환경으로 작업합니다. Remote Control은 같은 화면을 사용하지만 실제 실행은 내 컴퓨터의 로컬 세션에서 이루어집니다. 저장소 연결과 실행 위치를 구분해 선택하세요.
6. 자주 묻는 질문
파일을 실수로 수정하면 어떻게 복구하나요?
+
Claude Code는 편집 전 파일 내용을 체크포인트로 저장하므로 Esc를 두 번 누르거나 되감기 기능으로 세션의 파일 변경을 복구할 수 있습니다. 다만 외부 API·배포·데이터베이스 같은 원격 작업은 체크포인트로 되돌릴 수 없으므로 Git과 별도 백업을 함께 사용하세요.
한국어로 지시해도 되나요?
+
네, 한국어로 지시해도 잘 이해합니다. 코드나 파일명은 영어로 작성되더라도 지시는 한국어로 해도 무방합니다.
어떤 프로그래밍 언어를 지원하나요?
+
JavaScript, TypeScript, Python, Java, C/C++, Go, Rust 등 대부분의 언어를 지원합니다. HTML/CSS, 마크다운, 설정 파일 등도 처리할 수 있습니다.
Shift+Tab으로 뭘 할 수 있나요?
+
CLI에서 Shift+Tab을 누르면 기본 모드, acceptEdits, Plan 모드를 순환합니다. 계정·설정에 따라 Auto나 우회 모드가 추가될 수 있으며 dontAsk는 기본 순환에 포함되지 않습니다. 데스크톱은 별도의 권한 모드 메뉴를 사용합니다.
7. 참고 자료
관련 가이드
함께 보면 좋은
Claude Code
Claude Code는 Anthropic의 AI 코딩 에이전트입니다. 터미널·데스크톱 Code 탭·IDE·웹에서 프로젝트를 읽고 파일 편집, 명령 실행과 테스트를 수행합니다. 무료 플랜이 아닌 지원 구독이나 API 종량제 계정이 필요합니다.
클로드
클로드는 Anthropic이 개발한 AI 대화형 어시스턴트입니다. 질문 답변, 글쓰기, 번역, 코딩, 문서 분석 등 다양한 작업을 자연어로 요청할 수 있으며, PC와 모바일 앱에서 무료로 사용할 수 있습니다.
VS Code
VS Code는 Microsoft가 제공하는 Windows·macOS·Linux용 코드 편집기입니다. 확장, 소스 제어, 터미널, 디버깅 기능을 한 작업 환경에서 구성할 수 있습니다.