Claude Code(클로드 코드) 사용법과 고급 사용팁

관리자 작성
작성일 2026.02.03 16:36

8 조회
목록

Claude Code란? ]

오늘날 많은 AI 개발 도구들이 존재하지만, Claude Code는 가장 사랑받는 선택지 중 하나로, 앤트로픽이 개발한 터미널 기반의 AI 도구이다. Claude Code를 활용하면 기획 문서로부터의 개발 그리고 디버깅과및 문제 해결, 자동화 등 전반적인 부분에서 AI의 도움을 받을 수 있다.

Claude Code는 터미널에서 실행되기에 기존 개발 환경에 얹어지며, CLI를 기반으로 하여 git이나 bash 등에도 제약 없이 접근이 가능하기에 널리 사용된다. 또한 Claude Code는 로컬 환경에서만 동작하기에 보안적으로도 안전하며, 작업을 요청한 경우 프로젝트 전체를 탐색하며 작업을 진행한다. 예를 들어 Claude Code를 사용하면, 다음과 같은 명령어들을 사용할 수 있다.

explain the folder structure(프로젝트 구조에 대해 설명해줘)
add a hello world function to the main file(hello world 함수를 메인 파일에 추가해줘)
commit my changes with a descriptive message(변경 사항들을 커밋해줘)
review my changes and suggest improvements(내 변경사항들을 리뷰하고 개선해줘)

[ Claude Code 설치하고 실행하기 ]

다음의 명령어를 사용하면 Claude Code를 설치하고 실행할 수 있다.

# Claude Code 설치
npm install -g @anthropic-ai/claude-code

# 프로젝트 디렉토리로 이동
cd your-project

## Claude Code 실행
claude

Claude Code는 터미널이 있는 모든 통합 개발 환경(IDE)에서 잘 작동한다. IntelliJ와 같은 Jetbrains 제품을 사용중이라면, 다음의 플러그인을 통해 Diff 보는 화면, 컨텍스트 공유 등과 같은 기능을 통해 사용성을 높일 수 있으니 설치해주도록 하자.

3232235521_2OIQmUkY_417be8972336bdf80adabacd74c35e2c6363fb4e.png

기본적으로 터미널에 claude를 입력하면 Claude Code를 실행시킬 수 있다. 만약 IntelliJ를 사용중이라면 위의 플러그인을 설치한 후에 Command + Esc 키로 claude code를 손쉽게 실행시킬 수 있다.

claude

이후에 다음과 같은 창이 나오면, proceed를 눌러주면 된다.

3232235521_6JlYGFEm_f6240b89b27c76e12b414f46156b09763b973a98.png

프로젝트에서 Claude Code를 처음 사용하고자 할 때, init 명령어를 호출해주면 좋다. 그러면 Claude Code는 프로젝트 폴더에 CLAUDE.MD 파일을 생성하고 그 안에 프로젝트 관련 정보들을 정리한다. 이를 통해 작업 시에 많은 컨텍스트를 얻으면서 더 좋은 성능을 보일 수 있다.

/init

만약 CLAUDE.MD 파일을 홈 디렉토리에 직접 생성하고 작성할 경우, 모든 프로젝트에 공통되는 규칙들을 정의할 수도 있다. 따라서 프로젝트 전반에 걸쳐 적용하기를 원하는 내용이라면 해당 경로에 직접 추가해주도록 하자. 만약 개인적인 선호도를 반영하는 로컬 전용 CLAUDE.MD를 원한다면, CLAUDE.local.MD 파일을 추가하고 해당 파일을 gitIgnore에 추가해두면 된다. CLAUDE는 해당 파일 역시 작업 시에 참조할 것이다.

~/.claude/CLAUDE.MD

init 명령어를 실행하면 Claude Code가 다음과 같이 프로젝트를 분석하기 시작할 것이다.

3232235521_Xwzdlhb4_89fc86e942b5cdc28da528f042a8f35de4b318c1.png

이후에 분석이 완료되고, 실제 CLAUDE.MD와 같은 파일을 생성하는 작업을 진행하게 될 때에는 다음과 같이 권한을 물어보게 된다. 상황에 맞게 필요한 옵션을 선택해주면 되고, 매번 권한을 물어보면 번거로우니 통상적으로 2번을 사용하게 된다.

Yes: 제안된 변경사항을 CLAUDE.md에 적용하고, 이후에도 물어봄
Yes, and don’t ask again this session: 이번 세션 동안 모든 변경사항을 자동 적용함
No, and tell Claude what to do differently: 변경을 적용하지 않고 Claude에게 피드백을 줌

3232235521_VP9F5RUD_096ec603fa8f14819760fed476026a27c83955a6.png

만약 매번 위와 같이 권한을 묻는 것이 번거롭다면, claude를 실행할 때 다음과 같이 --dangerously-skip-permissions 옵션과 함께 실행하여 권한 여부를 스킵시킬 수도 있다.

claude --dangerously-skip-permissions

만약 IntelliJ 플러그인을 통해 claude를 위의 옵션과 함께 실행시키고자 할때는 플러그인 설정을 다음과 같이 수정해주면 된다.

3232235521_sXCFWp0Z_a5dc585b7d26a270993fae1fba0513c96e78ce11.png

이후에는 Claude Code에게 CLI를 통해 요청을 전달하면, 해당 내용을 이해하고 수행해줄 것이다.

[ Claude Code 사용팁 ]

Claude Code를 통해 이전과 다른 새로운 작업을 시작할 때에는 항상 /clear를 통해 현재의 대화 내역을 초기화해주는 것이 좋다. 이를 통해 성능을 최적화하고 관련 없는 정보를 제거하여, Claude의 집중력이 흐트러지는 것을 방지할 수 있다.

/clear

Claude Code를 통해 요청을 전달하고자 할 때, 컨텍스트를 전달하고자 한다면 @를 사용하면 된다. 그러면 필요한 내용을 찾아서 전달할 수 있다.

3232235521_ZFXSs9N4_041ed965e42b5c570b20257b5378b9c208fd1680.png

Claude Code를 통해 여러 건의 작업을 연속적으로 처리해주어야 하는 경우에는 여러 명령들을 입력시켜 두면 된다. 그러면 Claude Code는 처리해야 하는 요청들을 쌓아두고, 현재 요청의 처리가 완료되면 이어서 해당 요청을 처리한다. 예를 들어 다음의 3가지 명령을 순차적으로 처리하도록 명령하고 싶은 경우, 각각의 명령어를 순차적으로 입력하고 엔터쳐주면 된다.

analyze current project
optimize performance by code refactoring
run and fix failed tests

명령을 요청하는 과정에서 개행이 필요한 경우에는 Shift + Enter(안되면 /terminal-setup) 혹은 Ctrl + J를 사용하면 된다. 그러면 다음과 같이 하나의 명령어에 개행을 넣을 수 있다.

3232235521_K8T3pWUh_b05f0c0e0094ab5dd45f9f4d7bf5ecd60896c886.png

만약 명령어에 클립보드의 이미지를 넣고 싶다면, Ctrl + V로 넣을 수 있다. 그러면 다음과 같이 이미지가 참조되며 해당 파일을 전달할 수 있다.

3232235521_UvaWKEYF_f5a878b44b6247821642e21dd63f5168522f005c.png

만약 이전에 수행했던 작업 내역을 기록해야 할 경우가 있다. 그러면 반복적으로 Claude Code에 동일한 명령을 내릴 필요가 없어진다. 이런 경우에는 #을 눌러서, 이전 작업을 CLAUDE.MD에 추가하여 기억시킬 수 있다.

또한 이전 채팅을 재활용하고 싶은 경우, 위 화살표 누르면 이전 채팅으로 갈 수 있고, Esc 두 번 누르면 모든 내역을 보고 원하는 대화 시점으로 돌아갈 수 있어 유용하다. 그 외에도 대화 기록을 정리하고 요약해서 컨텍스트를 남겨두는 compact, 이전 대화 내용을 이어가는 resume, 현재 세션의 내용을 파일 등으로 추출하는 export 등도 존재하니 필요에 맞게 사용해주도록 하자.

[ 요약 및 정리 ]

위에서 얘기한 Claude Code의 사용법을 요약 및 정리하면 다음과 같다.

IDE가 제공하는 터미널 환경에서 Claude Code 플러그인과 함께 사용하기
Claude Code를 --dangerously-skip-permissions 옵션과 함께 실행하기
새로은 프로젝트에 Claude Code를 처음 실행할 때 /init 해주기
새로운 작업을 시작하기 전에는 항상 /clear 하기
작업을 여러 건 해야하는 경우, 요청을 넣어둬서 연속적으로 이어서 시키기
개행을 위해서는 Shift + Enter(안되면 /terminal-setup) 혹은 Ctrl + J를 사용하기
컨텍스트를 불러올 경우에는 @를 사용하면 됨
클립보드의 이미지를 넣으려면 Ctrl + V로 넣을 수 있음
작업한 내역을 기록해야 할 경우에는 #으로 기억시키기
위 화살표 누르면 이전 챗으로 갈 수 있고, Esc 두 번 누르면 모든 메시지 볼 수 있음

2. Claude Code의 고급 활용법

[ Custom Command (커스텀 명령어) 생성하기 ]

우리는 무의식 중에 많은 작업들을 반복적으로 수행하고 있다. 예를 들어 GIT 커밋부터 PR 작성 그리고 코드 리뷰 등이 대표적인 예시이다. 이러한 부분들을 프롬프트로 작성해두고 명령어만 입력하면 Claude Code로 하여금 수행하게 할 수는 없을까? Claude Code는 커스텀 명령어를 제공하는데, 이를 통해 반복 작업을 자동화할 수 있다.

먼저 만들고자 하는 커스텀 명령어를 Claude Code 전체 명령어로 설정할지 혹은 특정 프로젝트에서만 사용할지 판단이 필요하다. 그에 맞게 다음의 폴더를 먼저 생성해주도록 하자.

// 특정 프로젝트에 종속적인 Slash 명령어 위치
mkdir -p .claude/commands

// 전역적인 Slash 명령어 위치
mkdir -p ~/.claude/commands

그런 다음 해당 폴더 하위에 마크다운 파일을 추가해주면 된다.

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md

그러면 이제 다음과 같이 파일 이름과 동일한 명령어를 Claude Code에서 실행할 수 있다.

3232235521_EuDHLTJU_61b8fd35adfd9359fc8810b36e05b153d93926a6.png

커스텀 커맨드에 인자가 필요한 경우, $ARGUMENTS를 활용해 입력받을 수 있으니, 필요에 맞게 활용해주도록 하자.

[ Claude Code Subagents ]

특정한 작업을 위한 워크플로와 향상된 컨텍스트 관리를 위해, Claude Code는 서브 에이전트 기능을 제공한다. 예를 들어 주어진 코드를 문제없이 개선시키는 리팩토링의 전문가가 필요한 경우에, 우리는 리팩토링을 전문으로 하는 서브 에이전트를 만들어 사용하는 것이다. 서브 에이전트를 위한 맞춤형 시스템 프롬프트 등을 제공하여 효율적인 문제 해결을 할 수 있는 것이다.

따라서 서브에이전트는 Claude Code가 작업을 위임할 수 있는 사전 구성된 AI 인격체로 이해되며, 각 서브에이전트는 다음과 같은 특징을 지닌다.

특정한 목적과 전문 영역이 있음
기본 대화와 별도로 자체 컨텍스트 창을 사용함
사용하도록 허용된 특정 도구로 구성 가능
행동을 안내하는 사용자 지정 시스템 프롬프트를 지님

Claude Code는 서브 에이전트의 전문 지식과 일치하는 작업을 발견하면, 해당 작업을 독립적으로 작업하고 결과를 반환하는 전문 서브에이전트에게 작업을 위임할 수 있다.

만약 직접 서브에이전트를 생성하기를 원한다면, /agents 명령어를 실행하고, 'Create New Agent’를 선택하면 된다. 그리고 다음을 참고하여 서브에이전트를 작성해주면 된다.

권장: 먼저 클로드를 생성하고, 사용자 정의를 통해 내 것으로 만들기
서브에이전트를 자세히 설명하고 언제 사용해야 하는지 설명하기
액세스 권한을 부여할 도구를 선택(또는 모든 도구를 상속하려면 비워 두기), 인터페이스에 사용 가능한 모든 도구가 표시되므로 쉽게 선택할 수 있음
클로드에서 생성하는 경우, e를 눌러 자체 편집기에서 시스템 프롬프트를 편집할 수도 있음

이후 다음과 같이 서브 에이전트를 사용하라고 claude code에게 명령해주면 된다. 자세한 서브에이전트 예시는 공식 문서의 예시를 참고해주도록 하자.

> Use the code-reviewer subagent to check my recent changes

우리가 직접 서브 에이전트를 매번 만들고 하는 것은 번거롭다. 전 세계의 개발자들이 활용하는 것은 비슷할 것이기에, Super Claude와 같은 이미 잘 만들어진 도구가 존재한다. 따라서 우리는 이를 잘 활용해주기만 하면 된다.

[ Claude Code 답변이 완료되면 Mac OS 시스템 알림 받기 ]

Claude Code는 비동기적으로 작업을 진행하기 때문에, 언제 Claude Code가 작업을 완려했는지 알기 어렵다. 따라서 답변이 완료되면 Mac OS 시스템 알림 받도록 하는 것이 유용하다. 관련 오픈 소스가 존재하므로, 이를 위해 다음과 같은 과정을 따라 설치해주도록 하자.

pip install claude-notify
.claude/settings.json 에 hooks 설정 추가

  "hooks": {
    "Notification": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "claude-notify hook"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "claude-notify hook"
          }
        ]
      }
    ]
  },

위와 같이 설정하면, Claude Code 작업이 완료되었을 때 시스템 알림을 받아 다음 작업을 즉각적으로 이어갈 수 있다.

3232235521_5elZ0vKX_01c0fb7dbe0cbd99d5ec4fd3665f1e61586aee11.png

그 외에도

인기검색어

메뉴
검색
with USB

Claude Code(클로드 코드) 사용법과 고급 사용팁

Claude Code란? ]

[ Claude Code 설치하고 실행하기 ]

[ Claude Code 사용팁 ]

[ 요약 및 정리 ]

2. Claude Code의 고급 활용법

[ Custom Command (커스텀 명령어) 생성하기 ]

[ Claude Code Subagents ]

[ Claude Code 답변이 완료되면 Mac OS 시스템 알림 받기 ]

Favorites

최근글

새댓글

작성자 정보

컨텐츠 정보

본문

Claude Code란? ]

[ Claude Code 설치하고 실행하기 ]

[ Claude Code 사용팁 ]

[ 요약 및 정리 ]

2. Claude Code의 고급 활용법

[ Custom Command (커스텀 명령어) 생성하기 ]

[ Claude Code Subagents ]

[ Claude Code 답변이 완료되면 Mac OS 시스템 알림 받기 ]

관련자료

Favorites

최근글

새댓글