클로드 코드 사용법: 설치 후 실제로 쓰는 법 (명령·VS Code)

Claude Code를 설치했다면, 이제 쓰는 법입니다. 핵심은 간단합니다 — 프로젝트 폴더에서 claude를 실행하고, 대화로 작업을 지시하면 클로드가 파일을 직접 읽고 고칩니다. 단, 파일을 바꾸기 전에는 항상 변경 내용(diff)을 보여주고 승인을 받습니다.

시작하기

1. 작업할 프로젝트 폴더에서 터미널을 열고 claude를 실행합니다. 첫 실행 시 브라우저 로그인(OAuth)을 한 번 합니다.
2. 환영 화면 뒤에 대화형 프롬프트가 뜹니다. 여기에 자연어로 작업을 지시하면 됩니다.

# 프로젝트 폴더로 이동 후
claude

실행한 폴더와 그 하위 파일을 클로드가 볼 수 있으니, 어느 폴더에서 실행하는지를 신경 쓰세요.

작업 지시 + 파일 참조

그냥 자연어로 요청하면 됩니다. 특정 파일을 콕 집으려면 @ 뒤에 경로를 입력합니다(자동완성 지원). 그 파일 내용이 대화에 바로 주입됩니다.

@src/pages/Home.tsx 헤더 문구를 'Welcome'으로 바꿔줘

클로드는 바꿀 내용을 diff(변경 미리보기)로 보여주고 승인을 요청합니다. 승인·거부·수정 요청을 고를 수 있습니다.

알아두면 좋은 명령·단축키

• / — 사용 가능한 슬래시 명령 목록
• @경로 — 특정 파일을 컨텍스트에 추가
• ! — 터미널 명령을 실행하고 그 결과를 클로드에 전달
• ? — 단축키 보기 / Tab 자동완성 / ↑ 이전 입력
• Esc — 진행 중인 작업 중단
• /rewind 또는 Esc 두 번 — 이전 체크포인트로 되돌리기(매 편집마다 스냅샷 저장)
• /login 계정 전환 · /mcp MCP 서버 관리

두 가지 사용 모드

• 대화형(기본): claude로 세션을 열고 여러 번 주고받으며 작업. 복잡한 구현에 적합.
• 원샷: claude -p "src/api 폴더에서 TODO가 남은 곳 전부 찾아줘"처럼 한 번 실행하고 결과만 받기. 스크립트·CI·단순 조회에 적합.

VS Code에서 쓰기

두 가지 방법이 있습니다.

• 공식 확장("Claude Code for VS Code"): 에디터 사이드바에 패널이 생기고, 변경을 diff 뷰로 보며 클릭으로 승인합니다. (Cursor에서도 VS Code 확장이라 작동)
• 내장 터미널에서 claude를 직접 실행: 파일 변경이 에디터 탭에 바로 반영됩니다. MCP 설정, ! 명령, 일부 슬래시 명령은 CLI(터미널)에서만 됩니다.

안전장치

Claude Code는 기본적으로 파일 쓰기·명령 실행 전에 승인을 요구합니다(Ask 모드). 위험한 명령(강제 푸시·삭제 등)을 막도록 권한을 설정할 수도 있습니다. 그리고 매 편집이 체크포인트로 저장되어 /rewind로 되돌릴 수 있습니다.

더 잘 쓰는 법

프로젝트의 구조·규칙·자주 쓰는 명령을 CLAUDE.md에 적어두면 매 세션이 빨라지고 실수가 줄어듭니다. 작성법은 CLAUDE.md 작성 가이드를 참고하세요. 외부 도구 연동은 MCP 연결 가이드.

고지: Claude Code는 Claude Pro·Max·Team·Enterprise 구독에 포함되거나 API 종량제로 쓸 수 있습니다(포함 범위·요금은 변동). 명령·단축키·확장 동작은 버전에 따라 바뀔 수 있으니 공식 문서(code.claude.com/docs)에서 최신 정보를 확인하세요. 본 사이트는 Anthropic 공식 사이트가 아닙니다.