Claude Code, Cursor, Loveable AI의 시대에 소프트웨어 개발 환경은 지각변동을 겪고 있습니다. 키보드 앞에 웅크려 코드 한 줄 한 줄을 수동으로 입력하는 개발자의 전통적인 모습은 더욱 협력적이고 지능적인 워크플로우로 빠르게 대체되고 있습니다. 이러한 혁명의 중심에는 AI 기반 코딩 도우미의 부상이 있으며, Anthropic의 Claude Code CLI는 터미널에서 작업하는 개발자에게 특히 강력한 도구로 두각을 나타냅니다.
그래픽 사용자 인터페이스도 나름의 장소가 있지만, 명령줄 인터페이스는 숙련된 개발자의 손에서 속도, 효율성, 자동화를 위한 확실한 챔피언으로 남아 있습니다. Claude Code CLI는 단순한 다른 챗봇이 아닙니다. 코드베이스를 이해하고, 명령을 실행하며, 심지어 프로젝트의 복잡성을 학습할 수 있는 에이전트 코딩 파트너입니다. 이는 여러분의 지능을 향상시키고, 지루한 작업을 자동화하며, 진정으로 중요한 것, 즉 복잡한 문제를 해결하고 혁신적인 소프트웨어를 구축하는 데 집중할 수 있도록 설계된 도구입니다.
이 포괄적인 가이드는 Claude Code CLI의 세계로 여러분을 깊이 안내할 것입니다. 단순한 명령어 목록을 넘어 생산성을 진정으로 10배 향상시킬 수 있는 워크플로우와 기술을 탐구할 것입니다. 숙련된 명령줄 베테랑이든, 개발 프로세스에서 AI의 힘을 이제 막 탐색하기 시작했든, 이 글은 Claude Code CLI를 마스터하고 더 효과적이고 효율적인 개발자가 되는 데 필요한 지식과 도구를 제공할 것입니다.
파트 1: 필수 요소 - 시작 및 실행
최대 생산성으로 개발 팀이 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하십니까?
Apidog는 여러분의 모든 요구 사항을 충족하며, Postman을 훨씬 저렴한 가격으로 대체합니다!
Claude의 모든 기능을 사용하기 전에 설정하고 세션 관리의 기본 사항을 배워야 합니다. 이 섹션에서는 초기 단계를 안내하고 Claude와의 대화를 시작, 중지 및 재개하는 기본적인 명령을 소개합니다.
1. 설치: AI 기반 개발을 위한 첫걸음
10배 생산성을 향한 여정은 단 하나의 명령으로 시작됩니다. Claude Code CLI는 npm(Node Package Manager)을 통해 배포되므로 Node.js가 설치된 모든 시스템에 쉽게 설치할 수 있습니다.
명령어:Bash
npm install -g @anthropic-ai/claude-code
기능: 이 명령은 Claude Code CLI를 시스템에 전역으로 설치합니다. 즉, 터미널의 어느 디렉토리에서든 claude
명령을 실행할 수 있습니다.
생산성 향상: 한 번의 설정으로 기기의 어디에서든 AI 코딩 도우미에 즉시 액세스할 수 있습니다. 브라우저나 별도의 애플리케이션으로 전환할 필요 없이 Claude는 항상 명령 하나로 사용할 수 있습니다.
2. 구성: 경험 미세 조정
작은 사용자 정의는 워크플로우에 큰 영향을 미칠 수 있습니다. 이 명령을 사용하면 Claude가 작업을 완료했을 때 알림을 보내는 방식을 설정할 수 있습니다.
명령어:Bash
claude config set --global preferredNotifChannel terminal_bell
기능: 긴 작업이 완료되었을 때 Claude가 터미널의 벨 소리를 울리도록 지시합니다.
생산성 향상: Claude가 완료했는지 터미널을 계속 확인하는 대신 다른 작업으로 전환하고 결과 검토 시 알림을 받을 수 있습니다. 이는 집중력을 유지하고 효율적으로 멀티태스킹하는 간단하면서도 효과적인 방법입니다.
3. claude
: 새로운 대화 시작
이것은 여러분에게 제2의 천성이 될 명령어입니다. Claude와의 새로운 대화를 위한 관문입니다.
명령어:Bash
claude
기능: Claude와 새로운 대화형 세션을 시작합니다.
생산성 향상: 모든 새로운 작업에 대해 깨끗한 상태를 제공합니다. 이를 통해 이전 대화의 컨텍스트가 현재 작업에 방해되지 않도록 하여 Claude로부터 더 정확하고 관련성 높은 응답을 얻을 수 있습니다.
4. claude --continue
또는 claude -c
: 중단했던 곳에서 다시 시작
방해는 모든 개발자의 일상입니다. 이 명령은 생각의 흐름을 잃지 않고 작업을 원활하게 재개할 수 있도록 보장합니다.
명령어:Bash
claude --continue
기능: 가장 최근의 Claude 세션을 전체 대화 기록 및 컨텍스트와 함께 재개합니다.
생산성 향상: 이는 엄청난 시간 절약입니다. 컨텍스트를 다시 설명하거나 이전 명령을 다시 실행할 필요가 없습니다. claude -c
를 입력하기만 하면 중단했던 곳으로 바로 돌아갈 수 있습니다.
5. claude --resume
또는 claude -r
: 여러 프로젝트를 쉽게 처리
여러 프로젝트를 작업하는 개발자에게는 컨텍스트 전환이 주요 생산성 저해 요인입니다. --resume
플래그가 해결책입니다.
명령어:Bash
claude --resume
기능: 과거 세션 목록을 표시하여 재개할 세션을 선택할 수 있습니다.
생산성 향상: 어떤 프로젝트에서도 컨텍스트를 잃지 않고 다른 프로젝트와 작업 간에 쉽게 전환할 수 있습니다. 이는 각 프로젝트마다 별도의 전용 AI 도우미를 갖는 것과 같습니다.
파트 2: 핵심 워크플로우 - 일상적인 사용
세션에 들어가면 강력한 "슬래시 명령어" 세트를 사용하여 Claude와 상호 작용하게 됩니다. 이는 대화를 관리하고, 컨텍스트를 제공하며, AI 파트너를 최대한 활용하기 위한 일상적인 도구입니다.
6. /init
: 프로젝트에 대한 Claude에게 지식 제공
/init
명령어는 프로젝트에서 Claude의 잠재력을 최대한 발휘하는 열쇠입니다. Claude가 코드베이스에 대해 학습하는 데 사용하는 특별한 파일을 생성합니다.
명령어:Bash
/init
기능: 프로젝트의 루트 디렉토리에 CLAUDE.md
파일을 생성합니다.
생산성 향상: CLAUDE.md
파일은 프로젝트의 아키텍처, 종속성, 코딩 컨벤션과 같은 상위 수준 정보를 저장할 수 있는 곳입니다. Claude는 이 파일을 읽어 더 컨텍스트 인식적이고 정확한 지원을 제공합니다. 이는 Claude에게 프로젝트에 대한 "기억"을 부여하는 것과 같습니다. > document the project architecture in CLAUDE.md
와 같은 프롬프트로 Claude에게 작성을 도와달라고 요청할 수도 있습니다.
7. /clear
: 완전한 재설정이 아닌 새로운 시작
때로는 완전히 새로운 세션을 시작하지 않고 세션 내에서 방향을 변경해야 할 때가 있습니다. /clear
명령은 이럴 때 완벽합니다.
명령어:Bash
/clear
기능: 현재 세션의 대화 기록과 컨텍스트를 재설정합니다.
생산성 향상: 이는 세션을 종료하고 새로 시작하는 것보다 훨씬 빠릅니다. 동일한 프로젝트 내에서 새로운 작업으로 전환할 때 이전 대화의 관련 없는 컨텍스트로 Claude를 혼동시키는 것을 방지하는 데 이상적입니다.
8. /compact
: 컨텍스트 창을 스마트하게 관리
Claude의 힘은 큰 컨텍스트 창에서 비롯되지만, 무한하지는 않습니다. /compact
명령은 대화를 더 오래 이어갈 수 있는 영리한 방법입니다.
명령어:Bash
/compact
기능: 현재 대화를 요약하여 주요 정보를 보존하면서 전체 토큰 수를 줄입니다.
생산성 향상: 이를 통해 컨텍스트 한계에 도달하지 않고도 Claude와 더 길고 복잡한 상호 작용을 할 수 있습니다. 이는 좋은 메모를 작성하는 방법을 아는 지능적인 도우미를 갖는 것과 같으므로 큰 그림에 집중할 수 있습니다.
9. /review
: AI 기반 코드 리뷰어
코드 리뷰는 코드 품질 유지에 필수적이지만, 병목 현상이 될 수 있습니다. /review
명령을 사용하면 코드에 대한 즉각적인 두 번째 시선을 가질 수 있습니다.
명령어:Bash
/review
기능: Claude에게 풀 리퀘스트, 특정 파일 또는 코드 블록을 검토하도록 요청합니다.
생산성 향상: Claude는 잠재적인 버그를 발견하고, 개선 사항을 제안하며, 스타일 가이드 준수 여부를 몇 초 만에 확인할 수 있습니다. 이는 코드 검토 및 병합에 걸리는 시간을 극적으로 줄이고 개발자로서 배우고 개선하는 데 도움이 됩니다.
10. /help
: 세션 내 치트 시트
많은 강력한 명령을 손끝에서 사용할 수 있으므로 하나를 잊기 쉽습니다. /help
명령은 친절한 알림입니다.
명령어:Bash
/help
기능: 사용 가능한 모든 슬래시 명령어와 간단한 설명을 나열합니다.
생산성 향상: 터미널을 떠나거나 문서를 검색할 필요가 없습니다. help
명령은 필요할 때 필요한 정보를 바로 제공합니다.
11. /model
: 작업에 적합한 도구 선택
Anthropic은 다양한 강점을 가진 모델 제품군을 제공합니다. /model
명령을 사용하면 즉시 모델을 전환할 수 있습니다.
명령어:Bash
/model
기능: 현재 세션에 대해 Opus와 같이 매우 고급 모델 또는 빠른 Sonnet과 같은 다른 Claude 모델을 선택할 수 있습니다.
생산성 향상: 이를 통해 특정 요구 사항에 가장 적합한 모델을 선택할 수 있는 유연성을 얻을 수 있습니다. 복잡한 아키텍처 문제에 대한 창의적인 솔루션이 필요하십니까? Opus로 전환하세요. 간단한 질문에 대한 빠른 답변이 필요하십니까? Sonnet이 바로 그것입니다.
파트 3: 프로젝트 마스터리 - 어떤 코드베이스든 이해하기
개발자가 직면하는 가장 큰 과제 중 하나는 새로운 프로젝트에 빠르게 익숙해지는 것입니다. 다음 프롬프트를 명령으로 사용하면 Claude가 어떤 코드베이스든 자신 있게 탐색하는 데 도움이 되는 전문가 가이드가 됩니다.
12. > summarize this project
이는 새로운 프로젝트를 이해하기 위한 시작점입니다.
프롬프트:
> summarize this project
기능: Claude에게 현재 프로젝트의 목적, 주요 기능 및 기술 스택을 포함한 상위 수준 개요를 제공하도록 요청합니다.
생산성 향상: 문서와 코드를 몇 시간 또는 며칠 동안 읽는 대신 몇 분 안에 간결한 요약을 얻을 수 있습니다. 이는 새로운 팀원이나 새로운 오픈 소스 프로젝트를 탐색할 때 매우 유용합니다.
13. > explain the folder structure
잘 조직된 프로젝트는 작업하기 즐겁지만, 익숙하지 않은 프로젝트는 미로 같을 수 있습니다. 이 프롬프트는 여러분의 지도입니다.
프롬프트:
> explain the folder structure
기능: Claude에게 프로젝트의 디렉토리 구조를 분석하고 각 폴더의 목적을 설명하도록 요청합니다.
생산성 향상: 프로젝트가 어떻게 구성되어 있는지, 주요 파일을 어디에서 찾을 수 있는지, 새로운 코드를 어디에 추가해야 하는지를 빠르게 이해할 수 있습니다. 이는 많은 답답한 시행착오를 줄여줍니다.
14. > find the files that handle user authentication
이것이 Claude의 지능이 진정으로 빛을 발하는 부분입니다. 특정 기능과 관련된 코드를 찾아달라고 요청할 수 있으며, Claude가 어려운 작업을 대신 해줄 것입니다.
프롬프트:
> find the files that handle user authentication
기능: 전체 코드베이스를 검색하고 사용자 인증을 담당하는 파일을 식별합니다.
생산성 향상: 이는 코드를 이해하는 초강력 검색 엔진을 갖는 것과 같습니다. 파일을 수동으로 검색하는 것보다 훨씬 빠르고 정확하며, 특정 기능을 이해하거나 수정하려고 할 때 엄청난 시간을 절약할 수 있습니다.
15. > explain the main architecture patterns used here
프로젝트의 아키텍처를 이해하는 것은 좋은 설계 결정을 내리는 데 중요합니다. 이 프롬프트는 프로젝트 설계의 상위 수준 보기를 제공합니다.
프롬프트:
> explain the main architecture patterns used here
기능: 코드베이스를 분석하고 모델-뷰-컨트롤러(MVC), 마이크로서비스 또는 모놀리식 아키텍처와 같이 사용하는 주요 아키텍처 패턴을 식별합니다.
생산성 향상: 이는 코드의 "무엇"뿐만 아니라 "왜"를 이해하는 데 도움이 됩니다. 작성하는 모든 새 코드가 프로젝트의 기존 설계와 일관성이 있는지 확인하는 데 필수적입니다.
파트 4: 고급 무기 - Claude 파워 유저 되기
생산성을 다음 단계로 끌어올릴 준비가 되셨습니까? 이러한 고급 명령과 기능은 여러분을 진정한 Claude 파워 유저로 만들 것입니다.
16. 사용자 정의 슬래시 명령어: 나만의 도구 구축
이는 Claude Code CLI의 가장 강력한 기능 중 하나입니다. 자신만의 사용자 정의 슬래시 명령을 생성하여 개인 워크플로우를 자동화할 수 있습니다.
작동 방식: 프로젝트 또는 홈 디렉토리의 .claude/commands
디렉토리에 마크다운 파일을 생성합니다. 파일 이름이 명령어 이름이 됩니다.
예시:
다음 내용으로 .claude/commands/test.md
파일을 생성합니다.Markdown
Run all the unit tests and report the results.
이제 Claude 세션에서 /project:test
를 입력하기만 하면 사용자 정의 명령을 실행할 수 있습니다.
생산성 향상: 이를 통해 워크플로우에 완벽하게 맞춤화된 개인화된 도구 세트를 생성할 수 있습니다. 테스트 실행, 스테이징 배포, 보일러플레이트 코드 생성 등 상상할 수 있는 모든 것에 대한 명령을 생성할 수 있습니다. 이는 반복적인 작업을 자동화하려는 개발자를 위한 최고의 생산성 해킹입니다.
17. claude mcp add
: Claude의 기능 확장
MCP(Model Context Protocol)는 Claude를 다른 도구 및 서비스에 연결할 수 있는 시스템입니다.
명령어:Bash
claude mcp add playwright npx @playwright/mcp@latest
기능: 이 명령은 Playwright MCP를 Claude 인스턴스에 추가하여 웹 브라우저를 제어할 수 있는 기능을 부여합니다.
생산성 향상: MCP를 사용하면 Claude에게 초능력을 줄 수 있습니다. Claude에게 "우리 웹사이트로 이동하여 테스트 사용자로 로그인하고 대시보드 스크린샷을 찍어줘"라고 요청하는 것을 상상해 보세요. Playwright MCP를 사용하면 이것이 가능할 뿐만 아니라 쉽습니다.
18. permission.allow
/ permission.deny
: 보안 및 제어
Claude가 더욱 강력해짐에 따라 시스템에서 무엇을 할 수 있고 할 수 없는지를 제어하는 것이 중요합니다.
작동 방식: .claude/settings.json
파일을 편집하여 Claude가 실행할 수 있는 명령의 화이트리스트 또는 블랙리스트를 생성할 수 있습니다.
생산성 향상: 이를 통해 명시적으로 승인한 작업만 수행한다는 것을 알고 Claude를 안심하고 사용할 수 있습니다. 신뢰할 수 있는 자동화를 위해 --dangerously-skip-permissions
를 사용할 수도 있지만 주의해서 사용하십시오.
19. npx ccusage@latest
: 사용량 확인
토큰 사용량과 관련 비용을 추적하려는 개발자에게 이 명령은 필수입니다.
명령어:Bash
npx ccusage@latest
기능: 토큰 사용량 및 예상 비용에 대한 자세한 보고서를 제공합니다.
생산성 향상: 이를 통해 Claude를 어떻게 사용하고 있는지 이해하고 사용량에 대해 정보에 입각한 결정을 내릴 수 있습니다. 또한 프롬프트와 워크플로우를 최적화하여 토큰 효율성을 높일 기회를 식별하는 좋은 방법입니다.
20. > ultrathink ...
: Claude의 심층 사고 활용
이것은 특정 명령이 아니라 강력한 프롬프트 기법입니다. 특히 어려운 문제에 직면했을 때 Claude에게 "ultrathink" 해달라고 요청할 수 있습니다.
프롬프트:
> ultrathink how to design a scalable real-time chat application
기능: 이는 Claude가 피상적인 답변을 넘어 더 깊이 있고 구조화된 사고 과정에 참여하도록 장려합니다. 종종 문제를 더 작은 부분으로 나누고, 다른 접근 방식을 고려하며, 더 포괄적이고 합리적인 솔루션을 제공합니다.
생산성 향상: 이는 숙련된 아키텍트와 브레인스토밍 세션을 갖는 것과 같습니다. 새로운 아이디어를 발굴하고, 잠재적인 함정을 식별하며, 복잡한 기술적 과제에 대해 더 나은 결정을 내리는 데 도움이 될 수 있습니다.
파트 5: 에이전트 워크플로우 - 팀원으로서의 Claude
개발에서 AI의 진정한 미래는 Claude가 단순한 도구가 아닌 능동적이고 지능적인 팀원 역할을 하는 "에이전트 워크플로우"에 있습니다. 다음은 이 새로운 패러다임을 보여주는 몇 가지 고급 워크플로우입니다.
Claude와 함께하는 테스트 주도 개발(TDD)
TDD는 강력한 방법론이며, Claude는 이를 더욱 효율적으로 만들 수 있습니다.
워크플로우:
> write a failing test for the new feature
: 아직 존재하지 않는 기능에 대한 테스트를 작성하도록 Claude에게 요청합니다.- 테스트 실행: 테스트가 실패하는지 확인합니다.
> write the code to make the test pass
: 테스트를 통과하게 하는 코드를 작성하도록 Claude에게 요청합니다.- 테스트 다시 실행: 테스트가 이제 통과하는지 확인합니다.
- 리팩토링: 명확성과 효율성을 위해 코드를 리팩토링하도록 Claude에게 요청합니다.
생산성 향상: 이 워크플로우는 코드가 항상 테스트로 커버되도록 보장하여 더 높은 품질과 유지보수 가능한 소프트웨어로 이어집니다. Claude가 테스트와 구현 코드를 모두 빠르게 생성하는 능력은 TDD 주기를 믿을 수 없을 정도로 빠르고 효율적으로 만듭니다.
여러 Claude 인스턴스 사용
복잡한 작업의 경우 개발자 팀처럼 여러 Claude 인스턴스를 병렬로 사용할 수 있습니다.
워크플로우:
- 인스턴스 1 (개발자): 한 Claude 인스턴스를 사용하여 새 기능에 대한 코드를 작성합니다.
- 인스턴스 2 (리뷰어): 두 번째 Claude 인스턴스(새 터미널 창에서)를 사용하여 첫 번째 인스턴스가 작성한 코드를 검토합니다.
- 인스턴스 3 (리팩토링): 세 번째 인스턴스를 사용하여 리뷰어의 피드백을 기반으로 코드를 리팩토링합니다.
생산성 향상: 이를 통해 작업을 병렬화하고 코드에 대한 여러 "관점"의 이점을 얻을 수 있습니다. 이는 크고 복잡한 프로젝트에서 코드 품질을 개선하고 개발 프로세스 속도를 높이는 강력한 방법입니다.
결론: 코드의 미래는 대화입니다
Claude Code CLI는 단순한 명령어 모음이 아닙니다. 코드를 상호 작용하는 새로운 방식입니다. 컴퓨터에게 모든 지침을 지시하는 독백에서, 지능적인 파트너와 협력하여 목표를 달성하는 대화로의 전환입니다.
이 가이드에 설명된 명령과 워크플로우를 마스터함으로써 새로운 도구를 배우는 것만이 아닙니다. 소프트웨어 개발의 미래를 받아들이는 것입니다. 지루하고 반복적인 작업에 시간을 덜 쓰고, 여러분이 사랑하는 창의적이고 도전적인 작업에 더 많은 시간을 할애할 수 있는 미래입니다. 생산성이 향상될 뿐만 아니라 곱해지는 미래입니다. 그러니 뛰어들어 실험을 시작하고, 개인 코딩 도우미로서 10배 개발자를 갖는 것이 어떤 것인지 발견하십시오. 대화는 이제 막 시작되었습니다.
최대 생산성으로 개발 팀이 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하십니까?
Apidog는 여러분의 모든 요구 사항을 충족하며, Postman을 훨씬 저렴한 가격으로 대체합니다!