두 달 동안 CC 초보자 가이드를 꼭 쓰고 싶었는데, 드디어 오늘 해냅니다.
Claude Code(약칭 CC)는 올해 제가 가장 추천하는 AI 제품입니다, 단연코요.
Claude Code라고 불리지만, 그 기능은 코딩을 훨씬 넘어서는 진정한 범용 에이전트입니다.
컴퓨터에서 해야 하는 많은 지루한 작업을 CC가 한 마디로 처리해 줍니다.
저는 CC를 질의응답, 글쓰기, 웹페이지 제작, 소프트웨어 개발, 데이터 분석, 심지어 급여 명세서 분할까지 사용합니다.
오디오와 이미지를 빠르게 합성해 비디오로 만드는 일도 CC가 해 줍니다.
CC를 위해, 저는 CC를 사용해서 Claude Code Now라는 오픈소스 런처를 직접 만들었고, GitHub에서 이미 400개의 스타를 받았습니다.
CC는 유명한 OpenAI 연구원 AK조차 뒤쳐지고 있다는 느낌을 받게 한 소프트웨어이기도 합니다.
이는 CC의 저자와 AK의 대화입니다. CC를 목표물에 겨냥하기만 하면, 모든 문제가 녹아 사라집니다!
저는 CC를 동료와 친구들에게 계속 추천해 왔고, 그들이 사용할 때마다 이 AI가 얼마나 똑똑한지 감탄했습니다.
하지만 CC를 추천하기가 그렇게 쉽지만은 않습니다. Anthropic의 CEO가 좀 무자비해서요...
계정 정지가 너무 잦아서, 한 달에 세 번씩이나 당할 때도 있어 감당하기 어렵습니다.
어쨌든 Claude Code의 연간 수익은 10억 달러이고, CEO는 중국 사용자들에게 크게 신경 쓰지 않는 것 같습니다.
그래서 저는 한 순간을 기다리고 있었습니다: 국내 오픈소스 모델의 코딩 능력이 한계를 돌파하는 순간을요.
월요일, 제 친구 Yang Pan이 단체 채팅방에서 신나서 말하길, 그 순간이 왔다고!
이제 드디어 Claude Code 안에서 진정으로 사용할 수 있는 오픈소스 모델이 생겼습니다.
드디어 초보자들을 위한 Claude Code 초보자 가이드를 쓸 수 있게 되었네요.
친절한 안내: 이 글은 꽤 깁니다. 단계를 따라 하는 데 약 1시간이 걸리니, 먼저 북마크해 두시는 걸 추천합니다.
여러분의 친구들도 컴퓨터에서 가장 똑똑한 AI를 경험해보고 싶다면, 이 글을 꼭 공유해 주세요!
Claude Code 설치 가이드
I. 기본 준비
- 안정적인 네트워크 환경을 준비하세요.
- 최신 버전의 Node.js를 여기서 설치하세요: https://nodejs.org/en/download/
- Windows 사용자는 Git for Windows도 설치해야 합니다: https://git-scm.com/download/win
II. CC 설치 시작하기
- 컴퓨터에서 "터미널"을 검색하여 엽니다. 이렇게 생겼습니다. 겁먹지 마세요. 그냥 멋진 AI 채팅 상자라고 생각하세요.
- 터미널에 다음 명령어를 붙여넣고 Enter 키를 누르세요: npm install -g @anthropic-ai/claude-code
여기서 다양한 오류가 발생할 수 있습니다. 이미 Cursor와 같은 다른 AI 프로그래밍 도구를 설치했다면, 그 도구 안에서 설치하는 것을 강력히 권장합니다. 문제 해결에 도움이 될 것입니다.
다른 도구가 없다면, 아무 AI에게나 오류 해결을 요청하세요.
- 방법 2가 실패하면 다음을 시도해 보세요:
macOS, Linux 또는 WSL을 사용하는 경우, 이 명령어를 붙여넣고 Enter 키를 누르세요:
Windows를 사용하는 경우, 이 명령어를 붙여넣고 Enter 키를 누르세요:
설치가 완료되면 claude --version을 입력하세요. 버전 번호가 나타나면 설치에 성공한 것입니다.
Claude Code의 새 버전은 귀찮은 인증 단계를 추가했습니다. 이 방법으로 건너뛸 수 있습니다.
~/.claude.json 파일에 구성 항목 "hasCompletedOnboarding": true를 추가하세요. 파일이 없다면 직접 만드세요.
다음과 같아야 합니다:
{ // ... 기타 설정 "hasCompletedOnboarding": true }
III. CC 서버 요금제 구매
앞서 말했듯이, 공식 CC는 정지에 무자비하므로 공식 구독을 권장하지 않습니다. 공식 버전을 잘 관리할 수 있다면 존경하지만, 아마 이 글을 읽고 있지 않을 겁니다.
CC를 잘 지원하는 국내 모델은 세 가지입니다: GLM 4.7, MiniMax M2.1, Kimi K2.
여기서는 GLM 4.7 구성을 예시로 사용하겠습니다. 국내 웹사이트라 사용하기 더 쉽습니다. 다른 모델도 비슷한 코딩 요금제를 가지고 있습니다.
- 계정을 등록하세요. Zhipu AI 오픈 플랫폼(https://open.bigmodel.cn/)에 방문하여 오른쪽 상단의 "회원가입/로그인"을 클릭하고 안내를 따르세요.
- API 키를 받으세요. 개인 센터에서 API 키를 클릭하여 새 키를 만들고 나중에 사용할 수 있도록 복사하세요.
- 코딩 요금제에 가입하세요. 요금제를 이용하면 예상치 못한 잔액 문제에 대해 걱정 없이 자유롭게 사용할 수 있습니다.
현재 새해 특가가 진행 중입니다: 분기별 Coding Lite 요금제를 강력히 추천합니다. 3개월에 단 54위안으로 거의 공짜나 다름없습니다.
여기서 구매할 수 있습니다: https://www.bigmodel.cn/glm-coding?ic=KSGMCBOXUT
IV. CC 서버 구성
코딩 요금제를 확보했다면, 이제 구성할 차례입니다.
Coding Tool Helper라는 새로운 도구를 사용할 것입니다.
이 도구를 사용하면 GLM 서버 구성을 CC에 쉽게 가져올 수 있습니다.
- 터미널로 돌아가서 다음 명령어를 입력하고 Enter 키를 누르세요:
npx @z_ai/coding-helper
- 친숙한 중국어 인터페이스가 나타납니다.
- 도구의 안내에 따라, 앞서 받은 API 키를 붙여넣고 단계별로 완료하세요.
V. Claude Code 실행!
🎉 축하합니다. 가장 강력한 AI 도구를 설치했습니다. 잠시 숨을 고르세요.
물 한 잔 마시고, 실행해 보세요!
잠깐, 어떻게 실행하나요?
터미널에서 claude를 입력하고 Enter 키를 누르기만 하면 됩니다. 아래와 같은 인터페이스가 나타납니다.
인사하고 자신을 소개하세요!
이제부터 이 녀석이 여러분의 만능 도우미입니다.
이렇게 여는 방식이 익숙하지 않을 수 있습니다. 괜찮습니다. 제가 만든 런처인 Claude Code Now를 https://claudecodenow.com/에서 설치할 수 있습니다.
설치 후에는 어떤 폴더에서든 Claude Code를 볼 수 있습니다. 클릭하기만 하면 실행됩니다. 정말 편리합니다.
VI. Claude Code 사용 팁
Claude Code는 배울 것이 많습니다.
하지만 기본은 CC의 작동 방식을 이해하는 데 초점을 맞춘 세 가지로 요약됩니다.
CC를 시스템을 작동할 수 있는 에이전트라고 생각하면 됩니다. 컴퓨터를 보고, 파일을 읽고, 파일을 조작하고, 파일을 분석하고, 파일을 출력할 수 있습니다.
자연어 대화로 소통합니다. 코드를 한 줄도 작성할 필요가 없습니다.
- 폴더
폴더는 CC의 가장 뛰어난 디자인 개념입니다. CC의 놀이터와 같습니다.
CC가 시작될 때 폴더를 지정해야 하며, 이 폴더가 작업의 컨텍스트가 됩니다.
다양한 CC 프로젝트를 위해 전용 Claude Code 폴더를 만들 것을 강력히 권장합니다.
아래는 제 CC 폴더입니다. 노트, 데이터 분석, 심층 읽기, 소프트웨어 개발에 사용합니다. 각 작업마다 별도의 폴더를 사용하여 서로 간섭하지 않도록 합니다.
폴더를 지정하는 방법은 두 가지입니다. 하나는 위에서 언급한 Claude Code Now를 사용하는 것입니다. 다른 하나는 폴더를 CC로 드래그하는 것입니다. 그러면 자동으로 읽습니다.
파일도 마찬가지입니다. 파일을 CC로 직접 드래그할 수 있습니다. 이것이 첫 번째로 매우 중요한 팁입니다.
- Claude.md 파일
Claude.md 파일은 CC의 핵심 구성 파일이자 장기 기억입니다.
이 파일을 CC의 헌법이라고 생각하면 됩니다.
CC가 시작될 때마다 이 파일을 자동으로 로드하며, 여기에는 수행하려는 작업과 CC에 부여한 규칙이 기록됩니다.
CC가 이 파일을 직접 만들도록 하고, 중요하다고 생각하는 정보를 알려줄 수도 있습니다.
- 위험 모드
위험 모드란 무엇일까요?
이름에서 알 수 있듯이, 활성화되면 CC가 사용자의 확인 없이 컴퓨터를 완전히 자동화할 수 있습니다.
위험하게 들리지만, 활성화하지 않으면 모든 작업을 하나하나 확인해야 하므로 지루하고 효율성이 떨어집니다.
런처로 Claude Code Now를 사용한다면, 이미 위험 모드를 활성화해 두었습니다.
그렇지 않다면 다음 코드로 수동으로 활성화할 수 있습니다:
claude --dangerously-skip-permissions
하지만 활성화하면 CC가 돌이킬 수 없는 손상을 초래할 수 있으므로, 올바른 폴더를 지정하고 백업을 유지해야 합니다.
이제 세 가지 중요한 사항을 다루었으니, 매우 실용적인 팁 하나를 알려드리겠습니다: 이미지 붙여넣기.
CC를 사용하면 무엇이든 물어볼 수 있습니다. 하지만 일부 질문에는 이미지가 필요합니다. 이미지를 CC에 붙여넣어야 합니다.
CC는 터미널에서 실행되므로 붙여넣기 명령어가 시스템 기본값과 다릅니다. Cmd+V가 아니라:
Control + V
붙여넣기 후 CC는 이미지를 볼 수 있습니다.
VII. 실제 사용 사례: 급여 명세서 분할
이제 제가 업무에서 겪었던 실제 사례를 통해 CC의 마법을 확인해 보겠습니다.
회사 대표이자 회계사로서, 매달 모든 직원에게 급여를 지급해야 합니다.
지급 후에는 개별 급여 명세서를 발송해야 합니다.
하지만 에이전트는 다음과 같은 급여 테이블 하나만 제공합니다:
이 테이블을 분할하여 각 행을 별도의 파일로 만들고, 각 담당자에게 보내야 합니다.
이런 반복적인 노동은 매우 짜증납니다.
하지만 CC를 사용하면 요구 사항을 말로 전달하기만 하면 됩니다:
"이것은 급여 테이블입니다. 각 사람마다 하나의 파일로 개별 급여 명세서로 분할해 주세요."
시작부터 명령어 입력, 완료까지의 전체 과정을 편집 없이 녹화했습니다.
놀랍지 않나요! 이 지루한 작업은 총 29초밖에 걸리지 않았습니다!
이것은 하나의 작은 사례에 불과합니다. 실제로 CC가 할 수 있는 일은 수만 가지입니다.
다음에 반복적인 작업이 있다면, CC를 열고 대화를 나눠보는 건 어떨까요?
VIII. 스킬 로딩: 패키지화된 워크플로우
스킬은 Claude Code에 최근 도입된 주요 기능입니다.
스킬은 다른 사람들이 이미 테스트하고 검증한 워크플로우라고 생각하면 됩니다. 빌려서 사용하기만 하면 됩니다.
기존 스킬 웹사이트에서 복사하거나 CC가 직접 만들도록 할 수 있습니다. 여기 공식 스킬 가이드가 있습니다: https://github.com/anthropics/skills
스킬 사용은 매우 간단합니다. 예를 들어, 저는 방금 Mr. Liu Xiaopai가 공유한 프론트엔드 디자인 스킬을 보았습니다 (그는 CC 전문가입니다. 더 많은 팁을 보려면 그의 공개 계정을 팔로우하세요).
먼저 한 문장으로 스킬을 설치합니다:
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
그런 다음 CC에 지시합니다:
@anthropics/skills/frontend-design 스킬을 사용하여 https://listenhub.ai의 홈페이지를 재설계해 주세요
결과는 매우 고급스럽습니다. AI가 디자인한 웹페이지의 기본 남보라색 느낌을 완전히 피했습니다.
결론: 고래가 쓰러지면 만물이 번성한다
이것으로 Claude Code 초보자 슈퍼 가이드를 마칩니다.
위의 단계는 지능적인 업무와 학습 여정의 시작에 불과합니다. 배울 것은 훨씬 더 많습니다.
첫 걸음이 항상 가장 어렵습니다. 이 글은 그 부분을 다룹니다. 이제부터 문제가 발생하면 CC에게 물어보기만 하면 됩니다. CC가 해결해 줄 것입니다.
곧 여러분만의 "와우 모먼트"를 찾게 될 것이라고 확신합니다!
글을 마무리하면서, Yang Pan과의 저녁 자리에서 GLM 4.7 모델의 중요성에 대해 논의했던 일이 떠오릅니다.
예전에는 Claude Code가 거대 고래인 Anthropic이 독점하는 10억 달러 규모의 사업이었습니다.
이제 국내 오픈소스 모델이 따라잡았습니다. 이것이 우리가 오랫동안 기다려온 기술적 평등입니다.
오픈소스이기 때문에 모든 클라우드 제공업체가 이를 배포하고, 판매하고, 수익을 창출할 수 있습니다.
그리고 사용자는 1%의 가격으로 지능의 편리함을 얻습니다.
우리가 곧 보게 될 것은 전체 오픈소스 생태계의 번영과 Vibe Coding이 장난감에서 생산 도구로 변모하는 것입니다.
거대 고래는 여전히 있지만,
바다 깊은 곳에서는,
만물이 자라고 있습니다.
