클로드 코드를 켰는데 까만 창에 글자만 있으니까 무섭게 느껴지더라구요. 개발자용 도구처럼 보여서 첫 줄을 뭘 쳐야 할지 모르겠는 분 많으시죠?
💬 "설치는 했는데 화면이 낯설어서 그냥 껐어요."
💬 "터미널이라는 게 뭔지부터 모르겠어요."
💬 "노션이랑 연결된다는데 어디서 하는 건지 못 찾겠어요."
사실 클로드 코드는 평소 쓰던 챗 화면처럼 대화하면 되는 도구입니다. 다른 점은 결과물을 말로만 주는 게 아니라 파일을 직접 만들고, 다른 프로그램의 데이터를 가져오고, 노션에 쓰고 고치는 것까지 한다는 거예요.
VS 코드에 붙여서 쓰면 까만 터미널 대신 익숙한 편집기 화면에서 쓸 수 있습니다. 설치부터 한글 설정, 로그인, 노션 연결까지 순서대로 정리했어요.
CHAPTER 02
VS 코드에서클로드 코드 시작하기
설치는 네 단계입니다. 다른 프로그램 깔듯이 눌러 주시면 되고, 중간에 코드를 칠 일은 없어요.
VS 코드 말고 데스크톱 앱이나 터미널로 설치하고 싶다면 클로드 코드 설치 방법 3가지에서 세 가지를 비교해 보세요.
1단계. VS 코드 설치하기
먼저 VS 코드를 받습니다. 공식 사이트에서 받기 버튼을 누르면 쓰고 계신 운영체제에 맞는 파일이 내려옵니다. 맥을 쓰시면 맥용이 자동으로 뜨고요. 받은 뒤에는 다른 프로그램 설치와 똑같습니다.
2단계. 화면을 한글로 바꾸기
새로 설치하면 화면이 영어로 나옵니다. 한글로 바꿔두면 다음 단계가 훨씬 편해요.
왼쪽 확장 아이콘을 누르고 검색창에 Korean Language를 칩니다. 나오는 한국어 팩에서 사용을 누르면 화면이 한글로 바뀝니다.
3단계. 클로드 코드 확장 설치
같은 확장 검색창에 클로드 코드를 칩니다. Claude Code for VS Code가 나오면 설치 또는 사용을 누르세요.
그런 다음 VS 코드를 껐다 켭니다. 다시 열어서 왼쪽 클로드 코드 아이콘을 누르면 로그인하라는 안내가 뜨는데, 쓰고 계신 클로드 계정으로 로그인하면 됩니다.
💡 Tips
클로드 코드는 Pro 요금제부터 쓸 수 있습니다. 무료 계정으로 로그인하면 여기서 연결이 되지 않아요. 이미 클로드를 구독 중이시면 따로 결제하실 것 없이 그 계정으로 로그인하면 됩니다.
4단계. 폴더부터 열기
로그인이 끝나면 New Session을 눌러 새 대화를 엽니다. 그런데 대화를 시작하기 전에 할 일이 하나 있어요. 폴더를 먼저 여는 겁니다. 원하는 폴더를 만들어서 폴더를 여시면 그 폴더 안에서 세션이 작업한다고 생각하시면 됩니다.
클로드 코드에서 폴더는 작업 영역이에요. 여기서 만든 파일이 그 폴더 안에 쌓이고, 다음에 같은 폴더를 열면 하던 작업을 이어서 할 수 있습니다. 폴더 열기를 누르고 쓰실 경로를 고른 뒤 폴더 선택을 누르면 됩니다.
💡 Tips
폴더를 안 열고 시작하면 결과물이 어디에 저장되는지 알기 어렵습니다. 처음엔 바탕화면에 「클로드작업」처럼 이름을 정해 하나 만들어두고 거기서 시작하세요. 나중에 주제별로 나누면 됩니다.
CHAPTER 03
클로드 코드에노션 연결하기
여기까지 하면 클로드 코드와 대화가 가능해지죠. 그런데 내 노션을 읽고 쓰게 하려면 연결을 한 번 해줘야 하는데요, 이걸 MCP라고 부릅니다.
MCP는 어렵게 볼 것 없고, 클로드가 다른 프로그램에 들어갈 수 있게 문을 열어주는 것이라고 보시면 됩니다. 연결하는 길은 두 가지예요.
방법 1. 클로드 웹에서 연결
클로드 웹에 접속해서 커넥터로 들어갑니다. 검색창에 노션을 입력하고, 아래 나오는 노션을 클릭한 뒤 로그인해 연결하면 끝입니다. 이미 연결돼 있으면 연결됨이라고 표시돼요.
방법 2. 터미널에서 연결
VS 코드 상단 보기 → 터미널을 누릅니다. 아래에 창이 열리고 앞쪽에 아까 연 폴더 이름이 보일 거예요.
거기에 claude라고 입력하고 엔터를 칩니다. 쓸 모드를 고르라고 나오는데, 클로드를 구독 중이면 1번을 고르세요. 기존 계정과 연결하라는 안내가 뜨면 로그인하고, 승인 창이 나오면 승인을 누릅니다.
그다음 /mcp를 입력하면 MCP 목록이 나옵니다. 여기 노션이 「권한이 필요하다」고 표시돼 있을 거예요. 엔터를 치고 1번을 고르면 노션 연결 창이 뜨고, 리다이렉션과 계속하기를 차례로 누르면 됩니다. 권한 승인 창이 뜨고 승인하면 연결이 끝납니다.
클로드 웹에서 연결
눌러서 하는 방식. 처음이라면 이쪽이 편합니다.
터미널에서 연결
VS 코드 안에서 끝납니다. /mcp로 연결 상태를 바로 확인할 수 있어요.
연결은 됐는데 뭘 시켜야 할까
여기까지가 준비고, 진짜 어려운 건 그다음입니다. 노션이 붙었는데 막상 무슨 일을 맡길지가 안 떠오르는 경우가 많아요. 되는 건 알겠는데 내 업무 중에 뭘 넘겨야 할지 모르는 상태요.
처음 시켜보기 좋은 건 이미 손으로 하고 있는 반복 작업입니다. 메일함에서 이번 주 문의를 뽑아 노션에 정리하기, 쌓인 데이터를 분석해 주간 보고서로 만들기 같은 것들이요. 한 번 만들어두면 매주 같은 일이 자동으로 돕니다.
그 첫 일을 같이 정해보고 싶다면 투두투의 노션+AI로 쓰는 AI 직원 채용하기 실전 워크샵이 있어요. 3시간 동안 클로드 코드에 내 브랜드와 상품을 알려주고, 고객 후기를 정리해 보고하는 AI 직원 한 명을 직접 세워 봅니다. 코딩을 몰라도 따라올 수 있게 짜여 있습니다.
✍️ todoto Editor's Note
투두투가 클로드 코드를 회사 업무에 붙이면서 가장 많이 들은 말이 「설치는 했는데 그다음을 모르겠다」였어요. 그래서 지금은 처음 쓰는 분께 자동화부터 권하지 않습니다. 대신 이미 매주 손으로 하던 일 하나를 골라 그것만 맡겨보게 해요. 그 하나가 돌아가는 걸 보고 나면 다음에 뭘 넘길지는 스스로 떠오르거든요.
투두투 운영 기록
CHAPTER 04
클로드 코드 VS 코드자주 묻는 질문
❓ 자주 묻는 질문
Q. 클로드와 클로드 코드는 뭐가 다른가요?
클로드는 대화로 답을 받는 도구고, 클로드 코드는 그 답을 실제 파일·프로그램에 반영까지 해주는 도구예요. 삭제하고 고치는 권한까지 준다는 점이 가장 큰 차이입니다.
Q. 개발을 몰라도 쓸 수 있나요?
됩니다. 클로드 코드 창에서 평소처럼 한국어로 대화하면 돼요. VS 코드에 붙여 쓰면 터미널을 직접 다루지 않아도 대부분의 일이 화면에서 끝납니다.
Q. 설치했는데 클로드 코드 아이콘이 안 보여요.
확장을 설치한 뒤 VS 코드를 완전히 껐다 다시 켜야 아이콘이 나타납니다. 창만 닫지 말고 프로그램을 종료한 뒤 다시 여세요.
Q. 폴더는 꼭 열어야 하나요?
여는 걸 권합니다. 폴더가 작업 영역이라, 여기서 만든 파일이 그 폴더에 쌓이고 다음에 같은 폴더를 열면 이어서 작업할 수 있어요.
Q. 무료로도 쓸 수 있나요?
무료 계정으로는 쓸 수 없습니다. 클로드 코드는 Pro 요금제부터 쓸 수 있어요. 이미 구독 중이시면 추가 결제 없이 그 계정으로 로그인하면 됩니다.
Q. 노션 MCP 연결은 웹과 터미널 중 뭐가 낫나요?
처음이라면 클로드 웹 커넥터가 쉽습니다. VS 코드 안에서 끝내고 싶거나 연결 상태를 확인하고 싶으면 터미널에서 /mcp를 쓰세요. 둘 중 하나만 하면 됩니다.
개발자 화면 같아서 못 열고 있다면
클로드 코드를 켰는데 까만 창에 글자만 있으니까 무섭게 느껴지더라구요. 개발자용 도구처럼 보여서 첫 줄을 뭘 쳐야 할지 모르겠는 분 많으시죠?
💬 "설치는 했는데 화면이 낯설어서 그냥 껐어요."
💬 "터미널이라는 게 뭔지부터 모르겠어요."
💬 "노션이랑 연결된다는데 어디서 하는 건지 못 찾겠어요."
사실 클로드 코드는 평소 쓰던 챗 화면처럼 대화하면 되는 도구입니다. 다른 점은 결과물을 말로만 주는 게 아니라 파일을 직접 만들고, 다른 프로그램의 데이터를 가져오고, 노션에 쓰고 고치는 것까지 한다는 거예요.
VS 코드에 붙여서 쓰면 까만 터미널 대신 익숙한 편집기 화면에서 쓸 수 있습니다. 설치부터 한글 설정, 로그인, 노션 연결까지 순서대로 정리했어요.
VS 코드에서 클로드 코드 시작하기
설치는 네 단계입니다. 다른 프로그램 깔듯이 눌러 주시면 되고, 중간에 코드를 칠 일은 없어요.
VS 코드 말고 데스크톱 앱이나 터미널로 설치하고 싶다면 클로드 코드 설치 방법 3가지에서 세 가지를 비교해 보세요.
1단계. VS 코드 설치하기
먼저 VS 코드를 받습니다. 공식 사이트에서 받기 버튼을 누르면 쓰고 계신 운영체제에 맞는 파일이 내려옵니다. 맥을 쓰시면 맥용이 자동으로 뜨고요. 받은 뒤에는 다른 프로그램 설치와 똑같습니다.
2단계. 화면을 한글로 바꾸기
새로 설치하면 화면이 영어로 나옵니다. 한글로 바꿔두면 다음 단계가 훨씬 편해요.
왼쪽 확장 아이콘을 누르고 검색창에 Korean Language를 칩니다. 나오는 한국어 팩에서 사용을 누르면 화면이 한글로 바뀝니다.
3단계. 클로드 코드 확장 설치
같은 확장 검색창에 클로드 코드를 칩니다. Claude Code for VS Code가 나오면 설치 또는 사용을 누르세요.
그런 다음 VS 코드를 껐다 켭니다. 다시 열어서 왼쪽 클로드 코드 아이콘을 누르면 로그인하라는 안내가 뜨는데, 쓰고 계신 클로드 계정으로 로그인하면 됩니다.
💡 Tips
클로드 코드는 Pro 요금제부터 쓸 수 있습니다. 무료 계정으로 로그인하면 여기서 연결이 되지 않아요. 이미 클로드를 구독 중이시면 따로 결제하실 것 없이 그 계정으로 로그인하면 됩니다.
4단계. 폴더부터 열기
로그인이 끝나면 New Session을 눌러 새 대화를 엽니다. 그런데 대화를 시작하기 전에 할 일이 하나 있어요. 폴더를 먼저 여는 겁니다. 원하는 폴더를 만들어서 폴더를 여시면 그 폴더 안에서 세션이 작업한다고 생각하시면 됩니다.
클로드 코드에서 폴더는 작업 영역이에요. 여기서 만든 파일이 그 폴더 안에 쌓이고, 다음에 같은 폴더를 열면 하던 작업을 이어서 할 수 있습니다. 폴더 열기를 누르고 쓰실 경로를 고른 뒤 폴더 선택을 누르면 됩니다.
💡 Tips
폴더를 안 열고 시작하면 결과물이 어디에 저장되는지 알기 어렵습니다. 처음엔 바탕화면에 「클로드작업」처럼 이름을 정해 하나 만들어두고 거기서 시작하세요. 나중에 주제별로 나누면 됩니다.
클로드 코드에 노션 연결하기
여기까지 하면 클로드 코드와 대화가 가능해지죠. 그런데 내 노션을 읽고 쓰게 하려면 연결을 한 번 해줘야 하는데요, 이걸 MCP라고 부릅니다.
MCP는 어렵게 볼 것 없고, 클로드가 다른 프로그램에 들어갈 수 있게 문을 열어주는 것이라고 보시면 됩니다. 연결하는 길은 두 가지예요.
방법 1. 클로드 웹에서 연결
클로드 웹에 접속해서 커넥터로 들어갑니다. 검색창에 노션을 입력하고, 아래 나오는 노션을 클릭한 뒤 로그인해 연결하면 끝입니다. 이미 연결돼 있으면 연결됨이라고 표시돼요.
방법 2. 터미널에서 연결
VS 코드 상단 보기 → 터미널을 누릅니다. 아래에 창이 열리고 앞쪽에 아까 연 폴더 이름이 보일 거예요.
거기에 claude라고 입력하고 엔터를 칩니다. 쓸 모드를 고르라고 나오는데, 클로드를 구독 중이면 1번을 고르세요. 기존 계정과 연결하라는 안내가 뜨면 로그인하고, 승인 창이 나오면 승인을 누릅니다.
그다음 /mcp를 입력하면 MCP 목록이 나옵니다. 여기 노션이 「권한이 필요하다」고 표시돼 있을 거예요. 엔터를 치고 1번을 고르면 노션 연결 창이 뜨고, 리다이렉션과 계속하기를 차례로 누르면 됩니다. 권한 승인 창이 뜨고 승인하면 연결이 끝납니다.
연결은 됐는데 뭘 시켜야 할까
여기까지가 준비고, 진짜 어려운 건 그다음입니다. 노션이 붙었는데 막상 무슨 일을 맡길지가 안 떠오르는 경우가 많아요. 되는 건 알겠는데 내 업무 중에 뭘 넘겨야 할지 모르는 상태요.
처음 시켜보기 좋은 건 이미 손으로 하고 있는 반복 작업입니다. 메일함에서 이번 주 문의를 뽑아 노션에 정리하기, 쌓인 데이터를 분석해 주간 보고서로 만들기 같은 것들이요. 한 번 만들어두면 매주 같은 일이 자동으로 돕니다.
그 첫 일을 같이 정해보고 싶다면 투두투의 노션+AI로 쓰는 AI 직원 채용하기 실전 워크샵이 있어요. 3시간 동안 클로드 코드에 내 브랜드와 상품을 알려주고, 고객 후기를 정리해 보고하는 AI 직원 한 명을 직접 세워 봅니다. 코딩을 몰라도 따라올 수 있게 짜여 있습니다.
투두투가 클로드 코드를 회사 업무에 붙이면서 가장 많이 들은 말이 「설치는 했는데 그다음을 모르겠다」였어요. 그래서 지금은 처음 쓰는 분께 자동화부터 권하지 않습니다. 대신 이미 매주 손으로 하던 일 하나를 골라 그것만 맡겨보게 해요. 그 하나가 돌아가는 걸 보고 나면 다음에 뭘 넘길지는 스스로 떠오르거든요.
투두투 운영 기록
클로드 코드 VS 코드 자주 묻는 질문
❓ 자주 묻는 질문
Q. 클로드와 클로드 코드는 뭐가 다른가요?
클로드는 대화로 답을 받는 도구고, 클로드 코드는 그 답을 실제 파일·프로그램에 반영까지 해주는 도구예요. 삭제하고 고치는 권한까지 준다는 점이 가장 큰 차이입니다.
Q. 개발을 몰라도 쓸 수 있나요?
됩니다. 클로드 코드 창에서 평소처럼 한국어로 대화하면 돼요. VS 코드에 붙여 쓰면 터미널을 직접 다루지 않아도 대부분의 일이 화면에서 끝납니다.
Q. 설치했는데 클로드 코드 아이콘이 안 보여요.
확장을 설치한 뒤 VS 코드를 완전히 껐다 다시 켜야 아이콘이 나타납니다. 창만 닫지 말고 프로그램을 종료한 뒤 다시 여세요.
Q. 폴더는 꼭 열어야 하나요?
여는 걸 권합니다. 폴더가 작업 영역이라, 여기서 만든 파일이 그 폴더에 쌓이고 다음에 같은 폴더를 열면 이어서 작업할 수 있어요.
Q. 무료로도 쓸 수 있나요?
무료 계정으로는 쓸 수 없습니다. 클로드 코드는 Pro 요금제부터 쓸 수 있어요. 이미 구독 중이시면 추가 결제 없이 그 계정으로 로그인하면 됩니다.
Q. 노션 MCP 연결은 웹과 터미널 중 뭐가 낫나요?
처음이라면 클로드 웹 커넥터가 쉽습니다. VS 코드 안에서 끝내고 싶거나 연결 상태를 확인하고 싶으면 터미널에서 /mcp를 쓰세요. 둘 중 하나만 하면 됩니다.
👉 클로드를 더 알고 싶다면?
설치는 끝났어요 이제 시킬 차례입니다
매주 손으로 하던 일 하나만 골라 맡겨보세요.
한 번 만들어두면 그다음부터는 알아서 돕니다.
코딩을 몰라도 자동화는 만들 수 있어요.
연결한 클로드 코드로 첫 AI 직원을 세우고 싶다면
노션+AI로 쓰는 AI 직원 채용하기 실전 워크샵
오늘의 실천이 내일을 만든다