클로드 코드란? 코딩 몰라도 되는 이유

"나도 뭔가 하나 만들어 보고 싶은데, 코딩은 도저히 못 하겠다." 이런 생각을 한 번이라도 해 보셨다면 이 시리즈가 도움이 됩니다. 클로드 코드는 사람이 우리말로 부탁하면 그대로 파일을 만들어 주는 도구입니다. 만들어 달라고 말하면 만들어 주고, 색을 바꿔 달라고 하면 바꿔 줍니다.

이 글은 클로드 코드 왕초보 시리즈의 첫 번째 편입니다. 여기서는 설치를 하지 않습니다. 이 도구가 도대체 무엇을 해 주는 물건인지, 내 컴퓨터로 쓸 수 있는지만 확인합니다. 설치는 다음 편에서 합니다.

클로드 코드는 무엇을 하는 도구인가요

공식 문서는 클로드 코드를 이렇게 설명합니다. "코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합하는 에이전트 코딩 도구"입니다. 어려운 말이 섞여 있으니 하나씩 풀어 보겠습니다.

• 코드베이스는 프로그램을 이루는 파일 묶음입니다. 폴더 하나에 들어 있는 파일들이라고 생각하시면 됩니다.
• 파일을 편집한다는 것은 문서를 열어 내용을 고치는 일과 같습니다. 사람이 직접 고치는 대신 클로드가 고칩니다.
• 에이전트는 시켜 놓으면 알아서 여러 단계를 밟아 일을 끝내는 방식을 말합니다. 한 번 부탁하면 파일을 찾고, 고치고, 제대로 되었는지 확인하는 데까지 이어집니다.

정리하면 이렇습니다. 사람이 "이런 걸 만들어 줘"라고 말합니다. 클로드 코드는 필요한 파일을 찾아보고, 새로 만들거나 고친 다음, 무엇을 했는지 보고합니다. 사람은 그 결과를 보고 "좋다" 또는 "이 부분을 이렇게 바꿔 줘"라고 다시 말합니다. 이 주고받기가 전부입니다.

코딩을 몰라도 되는 이유

프로그램을 만들려면 원래 두 가지가 필요했습니다. 무엇을 만들고 싶은지 정하는 일, 그리고 그것을 컴퓨터가 알아듣는 글자로 옮겨 적는 일입니다. 어렵고 시간이 걸리는 쪽은 언제나 두 번째였습니다. 명령어 하나를 잘못 적거나 점 하나를 빠뜨리면 프로그램이 돌지 않았습니다.

클로드 코드는 그 두 번째 일을 대신합니다. 사람은 첫 번째만 하면 됩니다. "화면 가운데에 내 이름을 크게 쓰고, 그 아래에 좋아하는 것 세 가지를 적어 줘" 같은 문장이면 충분합니다. 만들어진 글자를 읽을 필요도 없습니다. 결과 화면만 보고 마음에 드는지 판단하시면 됩니다.

이 시리즈에서 만들어 볼 것

이 시리즈는 프로그래머를 만들지 않습니다. 목표는 하나입니다. 머릿속에 있던 것을 화면에서 실제로 움직이게 해 보는 것입니다. 앞으로 다음과 같은 것을 하나씩 만들어 봅니다.

1. 나를 소개하는 웹페이지
2. 버튼을 눌러 표시하는 할 일 체크리스트
3. 숫자 맞히기 게임
4. 용돈 기입장
5. 문제를 바꿔 끼울 수 있는 퀴즈
6. 공부 타이머

모두 파일 하나로 끝나고, 그 파일을 두 번 누르면 평소 쓰던 인터넷 창에서 바로 열립니다. 따로 더 설치할 것은 없습니다.

준비물 세 가지

시작하기 전에 확인할 것은 세 가지뿐입니다.

1. 컴퓨터. 맥은 macOS 13.0 이상, 윈도우는 윈도우 10 버전 1809 이상 64비트면 됩니다. 메모리는 4GB 이상을 권합니다. 요즘 쓰시는 컴퓨터라면 대개 해당됩니다.
2. 클로드 계정. 공식 문서는 Claude 구독(Pro, Max, Team, Enterprise) 또는 Claude Console 계정, 아니면 회사에서 쓰는 클라우드 서비스를 통한 접속이 필요하다고 안내합니다. 어떤 것을 고를지는 claude.com/pricing에서 직접 확인하시는 편이 정확합니다. 조건은 종종 바뀝니다.
3. 인터넷 연결. 클로드 코드는 인터넷을 통해 생각을 주고받습니다. 인터넷이 끊기면 동작하지 않습니다.

설치가 끝난 뒤 제대로 들어갔는지 확인하는 방법도 미리 알아 두시면 좋습니다. 다음 한 줄이 전부입니다.

claude --version

이 명령을 넣으면 버전 번호 뒤에 (Claude Code)가 붙어 나옵니다. 예를 들어 2.1.211 (Claude Code) 같은 모양입니다. 숫자는 사람마다 다릅니다. (Claude Code)라는 글자가 보이면 잘 들어간 것입니다.

꼭 터미널을 써야 하나요

이 시리즈는 터미널을 기준으로 진행합니다. 터미널은 그림이나 버튼 없이 글자로만 컴퓨터에 말을 거는 창입니다. 처음 보면 낯설지만, 우리가 쓸 기능은 몇 개 되지 않습니다.

공식 문서에 따르면 클로드 코드는 터미널 말고도 여러 곳에서 돌아갑니다. 따로 내려받는 데스크톱 앱이 있고, VS Code나 JetBrains 같은 편집 프로그램에 붙여 쓰는 방법도 있으며, 브라우저에서 바로 쓰는 방법도 있습니다. 나중에 편한 쪽으로 옮겨 가셔도 됩니다.

그래도 터미널로 시작하는 이유는 두 가지입니다. 첫째, 어느 컴퓨터에서나 모양이 같아서 글로 설명하기에 오해가 적습니다. 둘째, 설치와 확인이 짧은 한 줄로 끝납니다. 터미널을 여는 법부터 다음 편에서 그림처럼 하나하나 짚겠습니다.

다음 편에서 할 일

다음 편에서는 설치를 합니다. 쓰시는 컴퓨터에 맞는 편을 골라 보시면 됩니다. 윈도우를 쓰시면 윈도우 설치 편, 맥을 쓰시면 맥 설치 편입니다. 두 편 모두 붙여 넣을 명령은 딱 한 줄이고, 설치가 끝나면 화면에 Claude Code successfully installed!라고 나옵니다.

설치 도중에 빨간 글씨가 나오더라도 놀라지 않으셔도 됩니다. 자주 나오는 오류 문구와 그때 무엇을 하면 되는지를 따로 한 편에 모아 두었습니다.

자주 묻는 질문

함께 보면 좋은 글

• 클로드 코드 왕초보 시리즈 전체 목차 — 설치부터 따라 만들기까지 순서대로 모아 두었습니다.

참고: 클로드 코드 공식 문서 개요 · 공식 문서 빠른 시작