8 8
9Claude Code는 기능을 구축하고, 버그를 수정하고, 개발 작업을 자동화하는 데 도움이 되는 AI 기반 코딩 어시스턴트입니다. 전체 코드베이스를 이해하고 여러 파일과 도구에 걸쳐 작업할 수 있습니다.9Claude Code는 기능을 구축하고, 버그를 수정하고, 개발 작업을 자동화하는 데 도움이 되는 AI 기반 코딩 어시스턴트입니다. 전체 코드베이스를 이해하고 여러 파일과 도구에 걸쳐 작업할 수 있습니다.
10 10
11<h2 id="get-started">11## 시작하기
12 시작하기
13</h2>
14 12
15Claude Code는 터미널, IDE 확장 프로그램, 데스크톱 앱 및 웹을 포함한 여러 환경에서 실행됩니다. 아래 탭에서 하나를 선택하여 시작하세요. 대부분의 환경에는 [Claude 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) 또는 [Anthropic Console](https://platform.claude.com/) 계정이 필요합니다. Terminal CLI, VS Code 및 JetBrains는 [타사 제공자](/docs/ko/third-party-integrations)도 지원합니다.13Claude Code는 터미널, IDE 확장 프로그램, 데스크톱 앱 및 웹을 포함한 여러 환경에서 실행됩니다. 아래 탭에서 하나를 선택하여 시작하세요. 대부분의 환경에는 [Claude 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing) 또는 [Anthropic Console](https://platform.claude.com/) 계정이 필요합니다. Terminal CLI, VS Code 및 JetBrains는 [타사 제공자](/docs/ko/third-party-integrations)도 지원합니다.
16 14
17<Tabs>15**Terminal**
18 <Tab title="Terminal">
19 터미널에서 Claude Code로 직접 작업하기 위한 모든 기능을 갖춘 CLI입니다. 파일을 편집하고, 명령을 실행하고, 명령줄에서 전체 프로젝트를 관리할 수 있습니다.
20 16
21 Claude Code를 설치하려면 터미널을 열고 시스템에 맞는 명령을 실행하십시오. 이전에 터미널을 사용해본 적이 없다면 [터미널 가이드](/docs/ko/terminal-guide)에서 터미널을 열고 명령을 붙여넣는 방법을 확인할 수 있습니다.17터미널에서 Claude Code로 직접 작업하기 위한 모든 기능을 갖춘 CLI입니다. 파일을 편집하고, 명령을 실행하고, 명령줄에서 전체 프로젝트를 관리할 수 있습니다.
22 18
23 <Tabs>19Claude Code를 설치하려면 터미널을 열고 시스템에 맞는 명령을 실행하십시오. 이전에 터미널을 사용해본 적이 없다면 [터미널 가이드](/docs/ko/terminal-guide)에서 터미널을 열고 명령을 붙여넣는 방법을 확인할 수 있습니다.
24 <Tab title="기본 설치 (권장)">
25 **macOS, Linux, WSL:**
26 20
27 ```bash theme={null}21**기본 설치 (권장)**
28 curl -fsSL https://claude.ai/install.sh | bash
29 ```
30 22
31 Windows에서 PowerShell에 있을 때는 프롬프트에 `PS C:\`가 표시되고, CMD에 있을 때는 `PS` 없이 `C:\`만 표시됩니다.23**macOS, Linux, WSL:**
32 24
33 **Windows PowerShell:**25```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
26curl -fsSL https://claude.ai/install.sh | bash
27```
34 28
35 ```powershell theme={null}29Windows에서 PowerShell에 있을 때는 프롬프트에 `PS C:\`가 표시되고, CMD에 있을 때는 `PS` 없이 `C:\`만 표시됩니다.
36 irm https://claude.ai/install.ps1 | iex
37 ```
38 30
39 **Windows CMD:**31**Windows PowerShell:**
40 32
41 ```batch theme={null}33```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
42 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd34irm https://claude.ai/install.ps1 | iex
43 ```35```
44 36
45 설치 명령은 Claude Code를 다운로드하는 동안 진행 상황을 표시하지 않습니다. 설치 프로그램이 완료되면 새 터미널 창을 열고 `claude --version`을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다. 셸에서 `claude`를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다. [PATH 수정](/docs/ko/troubleshoot-install#command-not-found-claude-after-installation)을 참조하십시오.37**Windows CMD:**
46 38
47 `The token '&&' is not a valid statement separator` 오류가 표시되면 CMD가 아닌 PowerShell에 있는 것입니다. `'irm' is not recognized as an internal or external command` 오류가 표시되면 PowerShell이 아닌 CMD에 있는 것입니다.39```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
40curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
41```
48 42
49 설치 명령이 `syntax error near unexpected token '<'`, `403` 또는 다른 오류로 실패하면 [설치 문제 해결](/docs/ko/troubleshoot-install#find-your-error)을 참조하여 오류를 수정 방법과 일치시키고 대체 설치 방법을 확인하십시오.43설치 명령은 Claude Code를 다운로드하는 동안 진행 상황을 표시하지 않습니다. 설치 프로그램이 완료되면 새 터미널 창을 열고 `claude --version`을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다. 셸에서 `claude`를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다. [PATH 수정](/docs/ko/troubleshoot-install#command-not-found-claude-after-installation)을 참조하십시오.
50 44
51 [Git for Windows](https://git-scm.com/downloads/win)는 Claude Code가 Bash 도구를 사용할 수 있도록 기본 Windows에서 권장됩니다. Git for Windows가 설치되지 않은 경우 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다.45`The token '&&' is not a valid statement separator` 오류가 표시되면 CMD가 아닌 PowerShell에 있는 것입니다. `'irm' is not recognized as an internal or external command` 오류가 표시되면 PowerShell이 아닌 CMD에 있는 것입니다.
52 46
53 <Info>47설치 명령이 `syntax error near unexpected token '<'`, `403` 또는 다른 오류로 실패하면 [설치 문제 해결](/docs/ko/troubleshoot-install#find-your-error)을 참조하여 오류를 수정 방법과 일치시키고 대체 설치 방법을 확인하십시오.
54 기본 설치는 최신 버전으로 유지하기 위해 백그라운드에서 자동으로 업데이트됩니다.
55 </Info>
56 </Tab>
57 48
58 <Tab title="Homebrew">49[Git for Windows](https://git-scm.com/downloads/win)는 Claude Code가 Bash 도구를 사용할 수 있도록 기본 Windows에서 권장됩니다. Git for Windows가 설치되지 않은 경우 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다.
59 ```bash theme={null}
60 brew install --cask claude-code
61 ```
62 50
63 Homebrew는 두 가지 cask를 제공합니다. `claude-code`는 안정적인 릴리스 채널을 추적하며, 일반적으로 약 1주일 뒤에 있고 주요 회귀가 있는 릴리스를 건너뜁니다. `claude-code@latest`는 최신 채널을 추적하고 새 버전이 출시되는 즉시 받습니다.51> [!NOTE]
52>
53> 기본 설치는 최신 버전으로 유지하기 위해 백그라운드에서 자동으로 업데이트됩니다.
64 54
65 <Info>55**Homebrew**
66 Homebrew 설치는 자동으로 업데이트되지 않습니다. 설치한 cask에 따라 `brew upgrade claude-code` 또는 `brew upgrade claude-code@latest`를 실행하여 최신 기능 및 보안 수정 사항을 받으십시오.
67 </Info>
68 </Tab>
69 56
70 <Tab title="WinGet">57```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
71 ```powershell theme={null}58brew install --cask claude-code
72 winget install Anthropic.ClaudeCode59```
73 ```
74 60
75 <Info>61Homebrew는 두 가지 cask를 제공합니다. `claude-code`는 안정적인 릴리스 채널을 추적하며, 일반적으로 약 1주일 뒤에 있고 주요 회귀가 있는 릴리스를 건너뜁니다. `claude-code@latest`는 최신 채널을 추적하고 새 버전이 출시되는 즉시 받습니다.
76 WinGet 설치는 자동으로 업데이트되지 않습니다. 최신 기능 및 보안 수정 사항을 받으려면 주기적으로 `winget upgrade Anthropic.ClaudeCode`를 실행하십시오.
77 </Info>
78 </Tab>
79 </Tabs>
80 62
81 또한 Debian, Fedora, RHEL 및 Alpine에서 [apt, dnf 또는 apk](/docs/ko/setup#install-with-linux-package-managers)로 설치할 수 있습니다.63> [!NOTE]
64>
65> Homebrew 설치는 자동으로 업데이트되지 않습니다. 설치한 cask에 따라 `brew upgrade claude-code` 또는 `brew upgrade claude-code@latest`를 실행하여 최신 기능 및 보안 수정 사항을 받으십시오.
82 66
83 그런 다음 모든 프로젝트에서 Claude Code를 시작합니다. `your-project`를 머신의 프로젝트 디렉터리 경로로 바꾸세요:67**WinGet**
84 68
85 ```bash theme={null}69```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
86 cd your-project70winget install Anthropic.ClaudeCode
87 claude71```
88 ```
89 72
90 Claude Code는 처음 사용할 때 로그인을 요청합니다. `ANTHROPIC_API_KEY` 환경 변수를 설정했고 Claude Code가 키 사용 여부를 물을 때 키를 승인하면 Claude Code는 로그인 프롬프트를 건너뜁니다. [빠른 시작으로 계속하기 →](/docs/ko/quickstart)73> [!NOTE]
74>
75> WinGet 설치는 자동으로 업데이트되지 않습니다. 최신 기능 및 보안 수정 사항을 받으려면 주기적으로 `winget upgrade Anthropic.ClaudeCode`를 실행하십시오.
91 76
92 <Tip>77또한 Debian, Fedora, RHEL 및 Alpine에서 [apt, dnf 또는 apk](/docs/ko/setup#install-with-linux-package-managers)로 설치할 수 있습니다.
93 [고급 설정](/docs/ko/setup)에서 설치 옵션, 수동 업데이트 또는 제거 지침을 참조하세요. 문제가 발생하면 [설치 문제 해결](/docs/ko/troubleshoot-install)을 방문하세요.
94 </Tip>
95 </Tab>
96 78
97 <Tab title="VS Code">79그런 다음 모든 프로젝트에서 Claude Code를 시작합니다. `your-project`를 머신의 프로젝트 디렉터리 경로로 바꾸세요:
98 VS Code 확장 프로그램은 인라인 diff, @-mentions, 계획 검토 및 대화 기록을 편집기에서 직접 제공합니다.
99 80
100 * [VS Code용 설치](vscode:extension/anthropic.claude-code)81```bash theme={null}
101 * [Cursor용 설치](cursor:extension/anthropic.claude-code)82cd your-project
83claude
84```
102 85
103 또는 확장 프로그램 보기(`Mac에서 Cmd+Shift+X`, `Windows/Linux에서 Ctrl+Shift+X`)에서 "Claude Code"를 검색합니다. 설치 후 명령 팔레트(`Cmd+Shift+P` / `Ctrl+Shift+P`)를 열고 "Claude Code"를 입력한 다음 **새 탭에서 열기**를 선택합니다.86Claude Code는 처음 사용할 때 로그인을 요청합니다. `ANTHROPIC_API_KEY` 환경 변수를 설정했고 Claude Code가 키 사용 여부를 물을 때 키를 승인하면 Claude Code는 로그인 프롬프트를 건너뜁니다. [빠른 시작으로 계속하기 →](/docs/ko/quickstart)
104 87
105 [VS Code 시작하기 →](/docs/ko/vs-code#get-started)88> [!TIP]
106 </Tab>89>
90> [고급 설정](/docs/ko/setup)에서 설치 옵션, 수동 업데이트 또는 제거 지침을 참조하세요. 문제가 발생하면 [설치 문제 해결](/docs/ko/troubleshoot-install)을 방문하세요.
107 91
108 <Tab title="Desktop app">92**VS Code**
109 IDE 또는 터미널 외부에서 Claude Code를 실행하기 위한 독립 실행형 앱입니다. diff를 시각적으로 검토하고, 여러 세션을 나란히 실행하고, 반복되는 작업을 예약하고, 클라우드 세션을 시작할 수 있습니다.
110 93
111 다운로드 및 설치:94VS Code 확장 프로그램은 인라인 diff, @-mentions, 계획 검토 및 대화 기록을 편집기에서 직접 제공합니다.
112 95
113 * [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) (Intel 및 Apple Silicon)96* [VS Code용 설치](vscode:extension/anthropic.claude-code)
114 * [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) (x64)97* [Cursor용 설치](cursor:extension/anthropic.claude-code)
115 * [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)
116 * Ubuntu 또는 Debian에서 앱이 베타 버전이므로 [Linux 설치 지침](/docs/ko/desktop-linux)을 따라 apt로 설치합니다.
117 98
118 설치 후 Claude를 실행하고, 로그인한 다음 **Code** 탭을 클릭하여 코딩을 시작합니다. 앱에는 Claude Code가 포함되어 있으므로 CLI를 별도로 설치할 필요가 없습니다. [유료 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing)이 필요합니다.99또는 확장 프로그램 보기(`Mac에서 Cmd+Shift+X`, `Windows/Linux에서 Ctrl+Shift+X`)에서 "Claude Code"를 검색합니다. 설치 후 명령 팔레트(`Cmd+Shift+P` / `Ctrl+Shift+P`)를 열고 "Claude Code"를 입력한 다음 **새 탭에서 열기**를 선택합니다.
119 100
120 [데스크톱 앱에 대해 자세히 알아보기 →](/docs/ko/desktop-quickstart)101[VS Code 시작하기 →](/docs/ko/vs-code#get-started)
121 </Tab>
122 102
123 <Tab title="Web">103**Desktop app**
124 로컬 설정 없이 브라우저에서 Claude Code를 실행합니다. 오래 실행되는 작업을 시작하고 완료되면 다시 확인하거나, 로컬에 없는 리포지토리에서 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다. 더 오래 진행되는 작업의 경우 [프로젝트](/docs/ko/claude-projects)를 생성하고 Claude가 병렬 세션을 조정하도록 하세요. 데스크톱 브라우저 및 [iOS 및 Android용 Claude 앱](/docs/ko/mobile)에서 사용할 수 있습니다.
125 104
126 [claude.ai/code](https://claude.ai/code)에서 코딩을 시작합니다.105IDE 또는 터미널 외부에서 Claude Code를 실행하기 위한 독립 실행형 앱입니다. diff를 시각적으로 검토하고, 여러 세션을 나란히 실행하고, 반복되는 작업을 예약하고, 클라우드 세션을 시작할 수 있습니다.
127 106
128 [시작하기 →](/docs/ko/web-quickstart)107다운로드 및 설치:
129 </Tab>
130 108
131 <Tab title="JetBrains">109* [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) (Intel 및 Apple Silicon)
132 IntelliJ IDEA, PyCharm, WebStorm 및 기타 JetBrains IDE용 플러그인으로 대화형 diff 보기 및 선택 컨텍스트 공유 기능이 있습니다.110* [Windows](https://claude.ai/api/desktop/win32/x64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs) (x64)
111* [Windows ARM64](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs)
112* Ubuntu 또는 Debian에서 앱이 베타 버전이므로 [Linux 설치 지침](/docs/ko/desktop-linux)을 따라 apt로 설치합니다.
133 113
134 JetBrains Marketplace에서 [Claude Code 플러그인](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)을 설치하고 IDE를 다시 시작합니다. 플러그인에는 별도로 설치되는 Claude Code CLI가 필요합니다. [JetBrains 설정 단계](/docs/ko/jetbrains#installation)를 참조하세요.114설치 후 Claude를 실행하고, 로그인한 다음 **Code** 탭을 클릭하여 코딩을 시작합니다. 앱에는 Claude Code가 포함되어 있으므로 CLI를 별도로 설치할 필요가 없습니다. [유료 구독](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_desktop_pricing)이 필요합니다.
135 115
136 [JetBrains 시작하기 →](/docs/ko/jetbrains)116[데스크톱 앱에 대해 자세히 알아보기 →](/docs/ko/desktop-quickstart)
137 </Tab>
138</Tabs>
139 117
140<h2 id="what-you-can-do">118**Web**
141 할 수 있는 것
142</h2>
143 119
144Claude Code를 사용할 수 있는 몇 가지 방법은 다음과 같습니다:120로컬 설정 없이 브라우저에서 Claude Code를 실행합니다. 오래 실행되는 작업을 시작하고 완료되면 다시 확인하거나, 로컬에 없는 리포지토리에서 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다. 더 오래 진행되는 작업의 경우 [프로젝트](/docs/ko/claude-projects)를 생성하고 Claude가 병렬 세션을 조정하도록 하세요. 데스크톱 브라우저 및 [iOS 및 Android용 Claude 앱](/docs/ko/mobile)에서 사용할 수 있습니다.
145
146<AccordionGroup>
147 <Accordion title="계속 미루고 있는 작업 자동화" icon="wand-magic-sparkles">
148 Claude Code는 하루를 낭비하는 지루한 작업을 처리합니다: 테스트되지 않은 코드에 대한 테스트 작성, 프로젝트 전체의 lint 오류 수정, 병합 충돌 해결, 종속성 업데이트 및 릴리스 노트 작성.
149
150 ```bash theme={null}
151 claude "write tests for the auth module, run them, and fix any failures"
152 ```
153 </Accordion>
154
155 <Accordion title="기능 구축 및 버그 수정" icon="hammer">
156 원하는 것을 일반 언어로 설명합니다. Claude Code는 접근 방식을 계획하고, 여러 파일에 걸쳐 코드를 작성하고, 작동하는지 확인합니다.
157
158 버그의 경우 오류 메시지를 붙여넣거나 증상을 설명합니다. Claude Code는 코드베이스를 통해 문제를 추적하고, 근본 원인을 파악하고, 수정을 구현합니다. 더 많은 예제는 [일반적인 워크플로우](/docs/ko/common-workflows)를 참조하세요.
159 </Accordion>
160
161 <Accordion title="커밋 및 풀 요청 생성" icon="code-branch">
162 Claude Code는 git과 직접 작동합니다. 변경 사항을 스테이징하고, 커밋 메시지를 작성하고, 브랜치를 생성하고, 풀 요청을 엽니다.
163
164 ```bash theme={null}
165 claude "commit my changes with a descriptive message"
166 ```
167
168 CI에서 [GitHub Actions](/docs/ko/github-actions) 또는 [GitLab CI/CD](/docs/ko/gitlab-ci-cd)를 사용하여 코드 리뷰 및 이슈 분류를 자동화할 수 있습니다.
169 </Accordion>
170 121
171 <Accordion title="MCP로 도구 연결" icon="plug">122[claude.ai/code](https://claude.ai/code)에서 코딩을 시작합니다.
172 [Model Context Protocol (MCP)](/docs/ko/mcp)는 AI 도구를 외부 데이터 소스에 연결하기 위한 개방형 표준입니다. MCP를 사용하면 Claude Code는 Google Drive에서 설계 문서를 읽고, Jira에서 티켓을 업데이트하고, Slack에서 데이터를 가져오거나, 자신의 커스텀 도구를 사용할 수 있습니다. [MCP 빠른 시작](/docs/ko/mcp-quickstart)은 첫 번째 서버를 처음부터 끝까지 연결합니다.
173 </Accordion>
174 123
175 <Accordion title="지침, 스킬 및 훅으로 사용자 정의" icon="sliders">124[시작하기 →](/docs/ko/web-quickstart)
176 [`CLAUDE.md`](/docs/ko/memory)는 프로젝트 루트에 추가하는 마크다운 파일로 Claude Code가 모든 세션의 시작 부분에서 읽습니다. 이를 사용하여 코딩 표준, 아키텍처 결정, 선호하는 라이브러리 및 검토 체크리스트를 설정합니다. 저장소에 이미 다른 코딩 에이전트용 `AGENTS.md`가 있는 경우 Claude Code는 `CLAUDE.md` 대신 [해당 파일을 읽을 수 있습니다](/docs/ko/memory#agents-md). Claude는 또한 작업할 때 [자동 메모리](/docs/ko/memory#auto-memory)를 구축하여 세션 전체에서 학습 내용을 저장하므로 아무것도 작성할 필요가 없습니다.
177 125
178 [skills](/docs/ko/skills)를 생성하여 팀이 공유할 수 있는 반복 가능한 워크플로우를 패키징합니다(예: `/review-pr` 또는 `/deploy-staging`).126**JetBrains**
179 127
180 [Hooks](/docs/ko/hooks)를 사용하면 Claude Code 작업 전후에 셸 명령을 실행할 수 있습니다(예: 모든 파일 편집 후 자동 포맷팅 또는 커밋 전 lint 실행).128IntelliJ IDEA, PyCharm, WebStorm 및 기타 JetBrains IDE용 플러그인으로 대화형 diff 보기 및 선택 컨텍스트 공유 기능이 있습니다.
181 </Accordion>
182 129
183 <Accordion title="에이전트를 병렬로 실행하고 커스텀 에이전트 구축" icon="users">130JetBrains Marketplace에서 [Claude Code 플러그인](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)을 설치하고 IDE를 다시 시작합니다. 플러그인에는 별도로 설치되는 Claude Code CLI가 필요합니다. [JetBrains 설정 단계](/docs/ko/jetbrains#installation)를 참조하세요.
184 작업의 다른 부분에서 동시에 작동하는 [여러 Claude Code 에이전트](/docs/ko/sub-agents)를 생성합니다. 리드 에이전트가 작업을 조정하고, 하위 작업을 할당하고, 결과를 병합합니다.
185 131
186 여러 전체 세션을 병렬로 실행하고 한 화면에서 감시하려면 [백그라운드 에이전트](/docs/ko/agent-view)를 사용합니다. 완전히 커스텀 워크플로우의 경우 [Agent SDK](/docs/ko/agent-sdk/overview)를 사용하면 Claude Code의 도구 및 기능으로 구동되는 자신의 에이전트를 구축할 수 있으며, 오케스트레이션, 도구 액세스 및 권한에 대한 완전한 제어가 가능합니다.132[JetBrains 시작하기 →](/docs/ko/jetbrains)
187 </Accordion>
188 133
189 <Accordion title="CLI로 파이프, 스크립트 및 자동화" icon="terminal">134## 할 수 있는 것
190 Claude Code는 구성 가능하며 Unix 철학을 따릅니다. 로그를 파이프하고, CI에서 실행하거나, 다른 도구와 연결합니다:
191 135
192 ```bash theme={null}136Claude Code를 사용할 수 있는 몇 가지 방법은 다음과 같습니다:
193 # 최근 로그 출력 분석
194 tail -200 app.log | claude -p "Slack me if you see any anomalies"
195
196 # CI에서 번역 자동화
197 claude -p "translate new strings into French and raise a PR for review"
198
199 # 파일 전체에 걸친 대량 작업
200 git diff main --name-only | claude -p "review these changed files for security issues"
201 ```
202
203 전체 명령 및 플래그 세트는 [CLI 참조](/docs/ko/cli-reference)를 참조하세요.
204 </Accordion>
205
206 <Accordion title="반복되는 작업 예약" icon="clock">
207 Claude를 일정에 따라 실행하여 반복되는 작업을 자동화합니다: 아침 PR 검토, 야간 CI 실패 분석, 주간 종속성 감사 또는 PR 병합 후 문서 동기화.
208
209 * [Routines](/docs/ko/routines)는 클라우드에서 실행되므로 컴퓨터가 꺼져 있어도 계속 실행됩니다. API 호출 또는 GitHub 이벤트에서도 트리거될 수 있습니다. 웹, 데스크톱 앱에서 생성하거나 CLI에서 `/schedule`을 실행하여 생성합니다.
210 * [데스크톱 예약된 작업](/docs/ko/desktop-scheduled-tasks)은 머신에서 실행되며 로컬 파일 및 도구에 직접 액세스할 수 있습니다
211 * [`/loop`](/docs/ko/scheduled-tasks)는 빠른 폴링을 위해 CLI 세션 내에서 프롬프트를 반복합니다
212 </Accordion>
213
214 <Accordion title="어디서나 작업" icon="globe">
215 세션은 단일 환경에 연결되지 않습니다. 컨텍스트가 변경되면 환경 간에 작업을 이동합니다:
216
217 * 책상에서 떠나 [원격 제어](/docs/ko/remote-control)를 사용하여 휴대폰이나 모든 브라우저에서 계속 작업합니다
218 * [Dispatch](/docs/ko/desktop#sessions-from-dispatch)에 휴대폰에서 작업을 메시지로 보내고 생성되는 데스크톱 세션을 엽니다
219 * [웹](/docs/ko/claude-code-on-the-web) 또는 [Claude 모바일 앱](/docs/ko/mobile)에서 오래 실행되는 작업을 시작한 다음 `claude --teleport`를 사용하여 터미널로 가져옵니다. Teleport는 claude.ai 구독이 필요합니다.
220 * `/desktop`을 사용하여 현재 터미널 세션을 [데스크톱 앱](/docs/ko/desktop)에서 계속하여 시각적으로 diff를 검토할 수 있습니다. `/desktop` 핸드오프는 claude.ai 구독이 필요합니다. macOS 및 x64 Windows에서 사용 가능합니다.
221 * 팀 채팅에서 작업을 라우팅합니다: [Slack](/docs/ko/slack)에서 `@Claude`를 언급하고 버그 보고서를 포함하면 풀 요청을 다시 받습니다
222 </Accordion>
223</AccordionGroup>
224 137
225<h2 id="use-claude-code-everywhere">138> **계속 미루고 있는 작업 자동화**
226 모든 곳에서 Claude Code 사용139>
227</h2>140> Claude Code는 하루를 낭비하는 지루한 작업을 처리합니다: 테스트되지 않은 코드에 대한 테스트 작성, 프로젝트 전체의 lint 오류 수정, 병합 충돌 해결, 종속성 업데이트 및 릴리스 노트 작성.
141>
142> ```bash theme={null}
143> claude "write tests for the auth module, run them, and fix any failures"
144> ```
145
146> **기능 구축 및 버그 수정**
147>
148> 원하는 것을 일반 언어로 설명합니다. Claude Code는 접근 방식을 계획하고, 여러 파일에 걸쳐 코드를 작성하고, 작동하는지 확인합니다.
149>
150> 버그의 경우 오류 메시지를 붙여넣거나 증상을 설명합니다. Claude Code는 코드베이스를 통해 문제를 추적하고, 근본 원인을 파악하고, 수정을 구현합니다. 더 많은 예제는 [일반적인 워크플로우](/docs/ko/common-workflows)를 참조하세요.
151
152> **커밋 및 풀 요청 생성**
153>
154> Claude Code는 git과 직접 작동합니다. 변경 사항을 스테이징하고, 커밋 메시지를 작성하고, 브랜치를 생성하고, 풀 요청을 엽니다.
155>
156> ```bash theme={null}
157> claude "commit my changes with a descriptive message"
158> ```
159>
160> CI에서 [GitHub Actions](/docs/ko/github-actions) 또는 [GitLab CI/CD](/docs/ko/gitlab-ci-cd)를 사용하여 코드 리뷰 및 이슈 분류를 자동화할 수 있습니다.
161
162> **MCP로 도구 연결**
163>
164> [Model Context Protocol (MCP)](/docs/ko/mcp)는 AI 도구를 외부 데이터 소스에 연결하기 위한 개방형 표준입니다. MCP를 사용하면 Claude Code는 Google Drive에서 설계 문서를 읽고, Jira에서 티켓을 업데이트하고, Slack에서 데이터를 가져오거나, 자신의 커스텀 도구를 사용할 수 있습니다. [MCP 빠른 시작](/docs/ko/mcp-quickstart)은 첫 번째 서버를 처음부터 끝까지 연결합니다.
165
166> **지침, 스킬 및 훅으로 사용자 정의**
167>
168> [`CLAUDE.md`](/docs/ko/memory)는 프로젝트 루트에 추가하는 마크다운 파일로 Claude Code가 모든 세션의 시작 부분에서 읽습니다. 이를 사용하여 코딩 표준, 아키텍처 결정, 선호하는 라이브러리 및 검토 체크리스트를 설정합니다. 저장소에 이미 다른 코딩 에이전트용 `AGENTS.md`가 있는 경우 Claude Code는 `CLAUDE.md` 대신 [해당 파일을 읽을 수 있습니다](/docs/ko/memory#agents-md). Claude는 또한 작업할 때 [자동 메모리](/docs/ko/memory#auto-memory)를 구축하여 세션 전체에서 학습 내용을 저장하므로 아무것도 작성할 필요가 없습니다.
169>
170> [skills](/docs/ko/skills)를 생성하여 팀이 공유할 수 있는 반복 가능한 워크플로우를 패키징합니다(예: `/review-pr` 또는 `/deploy-staging`).
171>
172> [Hooks](/docs/ko/hooks)를 사용하면 Claude Code 작업 전후에 셸 명령을 실행할 수 있습니다(예: 모든 파일 편집 후 자동 포맷팅 또는 커밋 전 lint 실행).
173
174> **에이전트를 병렬로 실행하고 커스텀 에이전트 구축**
175>
176> 작업의 다른 부분에서 동시에 작동하는 [여러 Claude Code 에이전트](/docs/ko/sub-agents)를 생성합니다. 리드 에이전트가 작업을 조정하고, 하위 작업을 할당하고, 결과를 병합합니다.
177>
178> 여러 전체 세션을 병렬로 실행하고 한 화면에서 감시하려면 [백그라운드 에이전트](/docs/ko/agent-view)를 사용합니다. 완전히 커스텀 워크플로우의 경우 [Agent SDK](/docs/ko/agent-sdk/overview)를 사용하면 Claude Code의 도구 및 기능으로 구동되는 자신의 에이전트를 구축할 수 있으며, 오케스트레이션, 도구 액세스 및 권한에 대한 완전한 제어가 가능합니다.
179
180> **CLI로 파이프, 스크립트 및 자동화**
181>
182> Claude Code는 구성 가능하며 Unix 철학을 따릅니다. 로그를 파이프하고, CI에서 실행하거나, 다른 도구와 연결합니다:
183>
184> ```bash theme={null}
185> # 최근 로그 출력 분석
186> tail -200 app.log | claude -p "Slack me if you see any anomalies"
187>
188> # CI에서 번역 자동화
189> claude -p "translate new strings into French and raise a PR for review"
190>
191> # 파일 전체에 걸친 대량 작업
192> git diff main --name-only | claude -p "review these changed files for security issues"
193> ```
194>
195> 전체 명령 및 플래그 세트는 [CLI 참조](/docs/ko/cli-reference)를 참조하세요.
196
197> **반복되는 작업 예약**
198>
199> Claude를 일정에 따라 실행하여 반복되는 작업을 자동화합니다: 아침 PR 검토, 야간 CI 실패 분석, 주간 종속성 감사 또는 PR 병합 후 문서 동기화.
200>
201> * 이전에 루틴이라고 불렸던 [클라우드 예약 작업](/docs/ko/routines)은 클라우드에서 실행되므로 컴퓨터가 꺼져 있어도 계속 실행됩니다. API 호출 또는 GitHub 이벤트에서도 트리거될 수 있습니다. 웹, 데스크톱 앱에서 생성하거나 CLI에서 `/schedule`을 실행하여 생성합니다.
202> * [데스크톱 예약 작업](/docs/ko/desktop-scheduled-tasks)은 머신에서 실행되며 로컬 파일 및 도구에 직접 액세스할 수 있습니다
203> * [`/loop`](/docs/ko/scheduled-tasks)는 빠른 폴링을 위해 CLI 세션 내에서 프롬프트를 반복합니다
204
205> **어디서나 작업**
206>
207> 세션은 단일 사용 환경에 연결되지 않습니다. 컨텍스트가 변경되면 사용 환경 간에 작업을 이동합니다:
208>
209> * 책상에서 떠나 [원격 제어](/docs/ko/remote-control)를 사용하여 휴대폰이나 모든 브라우저에서 계속 작업합니다
210> * [Dispatch](/docs/ko/desktop#sessions-from-dispatch)에 휴대폰에서 작업을 메시지로 보내고 생성되는 데스크톱 세션을 엽니다
211> * [웹](/docs/ko/claude-code-on-the-web) 또는 [Claude 모바일 앱](/docs/ko/mobile)에서 오래 실행되는 작업을 시작한 다음 `claude --teleport`를 사용하여 터미널로 가져옵니다. Teleport는 claude.ai 구독이 필요합니다.
212> * `/desktop`을 사용하여 현재 터미널 세션을 [데스크톱 앱](/docs/ko/desktop)에서 계속하여 시각적으로 diff를 검토할 수 있습니다. `/desktop` 핸드오프는 claude.ai 구독이 필요합니다. macOS 및 x64 Windows에서 사용 가능합니다.
213> * 팀 채팅에서 작업을 라우팅합니다: [Slack](/docs/ko/slack)에서 `@Claude`를 언급하고 버그 보고서를 포함하면 풀 요청을 다시 받습니다
214
215## 모든 곳에서 Claude Code 사용
228 216
229각 [환경](/docs/ko/glossary#surface)은 동일한 기본 Claude Code 엔진에 연결되므로 CLAUDE.md 파일, 설정 및 MCP 서버가 모든 환경에서 작동합니다.217각 [환경](/docs/ko/glossary#surface)은 동일한 기본 Claude Code 엔진에 연결되므로 CLAUDE.md 파일, 설정 및 MCP 서버가 모든 환경에서 작동합니다.
230 218
235| 휴대폰이나 다른 기기에서 로컬 세션 계속하기 | [원격 제어](/docs/ko/remote-control) |223| 휴대폰이나 다른 기기에서 로컬 세션 계속하기 | [원격 제어](/docs/ko/remote-control) |
236| Telegram, Discord, iMessage 또는 자신의 웹훅에서 세션으로 이벤트 푸시 | [Channels](/docs/ko/channels) |224| Telegram, Discord, iMessage 또는 자신의 웹훅에서 세션으로 이벤트 푸시 | [Channels](/docs/ko/channels) |
237| 로컬에서 작업 시작, 모바일에서 계속 | [`claude --cloud`](/docs/ko/claude-code-on-the-web#from-terminal-to-cloud), 그 다음 [Claude 모바일 앱](/docs/ko/mobile) |225| 로컬에서 작업 시작, 모바일에서 계속 | [`claude --cloud`](/docs/ko/claude-code-on-the-web#from-terminal-to-cloud), 그 다음 [Claude 모바일 앱](/docs/ko/mobile) |
238| Claude를 반복 일정에 따라 실행 | [Routines](/docs/ko/routines) 또는 [데스크톱 예약된 작업](/docs/ko/desktop-scheduled-tasks) |226| Claude를 반복 일정에 따라 실행 | [클라우드 예약 작업](/docs/ko/routines) 또는 [Desktop 예약 작업](/docs/ko/desktop-scheduled-tasks) |
239| PR 검토 및 이슈 분류 자동화 | [GitHub Actions](/docs/ko/github-actions) 또는 [GitLab CI/CD](/docs/ko/gitlab-ci-cd) |227| PR 검토 및 이슈 분류 자동화 | [GitHub Actions](/docs/ko/github-actions) 또는 [GitLab CI/CD](/docs/ko/gitlab-ci-cd) |
240| 모든 PR에서 자동 코드 검토 받기 | [GitHub Code Review](/docs/ko/code-review) |228| 모든 PR에서 자동 코드 검토 받기 | [GitHub Code Review](/docs/ko/code-review) |
241| Slack의 버그 보고서를 풀 요청으로 라우팅 | [Slack](/docs/ko/slack) |229| Slack의 버그 보고서를 풀 요청으로 라우팅 | [Slack](/docs/ko/slack) |
242| 라이브 웹 애플리케이션 디버깅 | [Chrome](/docs/ko/chrome) |230| 라이브 웹 애플리케이션 디버깅 | [Chrome](/docs/ko/chrome) |
243| 자신의 워크플로우를 위한 커스텀 에이전트 구축 | [Agent SDK](/docs/ko/agent-sdk/overview) |231| 자신의 워크플로우를 위한 커스텀 에이전트 구축 | [Agent SDK](/docs/ko/agent-sdk/overview) |
244 232
245<h2 id="next-steps">233## 다음 단계
246 다음 단계
247</h2>
248 234
249Claude Code를 설치한 후 이 가이드를 통해 더 깊이 있게 알아볼 수 있습니다.235Claude Code를 설치한 후 이 가이드를 통해 더 깊이 있게 알아볼 수 있습니다.
250 236
