Table of Contents (목차)

1. 비개발자가 ‘검은 화면’ 터미널에 도전한 이유
2. 클로드 코드 설치와 ‘로그아웃’의 늪에서 살아남기
3. 사라진 내 코드? CLI 환경에서 파일 확인하는 법
4. 터미널 Git 연동: AI와 함께하는 개발자 워크플로우
5. 비개발자를 위한 클로드 코드 핵심 명령어 가이드
6. 직접 써보고 느낀 클로드 코드의 진짜 강점
7. 결론: 완벽보다 실행, AI와 협업하는 재미

1. 비개발자가 왜 ‘검은 화면:터미널’에 도전했나?

웹 브라우저에서 클로드(Claude)와 대화하는 것은 익숙하지만, 그 곳에서 클로드 코드를 어떻게 쓸 수 있는지 몰라서 일단 채팅 창에 코드 짜줘 를 반복 하다보니 많은 사람들이 말하는 ‘클로드 코드’는 그게 아니였다는 것을 7일 후에 알게 되었다.

그래서, AI 도움을 받아 찾아보니 터미널에서 실행되는 클로드 코드(Claude Code)는 차원이 달랐다. 코드를 복사해서 붙여넣을 필요 없이, AI가 내 컴퓨터의 파일을 직접 수정하고 명령어를 실행한다는 점이 매력적이였고, 오랜만에 깃허브도 연동을 하게 되었다.

그러나, 기쁨도 잠시 시작부터 난관이었다. “비개발자가 과연 이걸 쓸 수 있을까?”라는 의문과 함께 삽질은 시작되었다.

2. 클로드 코드(Claude Code) 설치와 로그인, 그리고 ‘로그아웃’의 늪

유치원? 초등학교때 DOS가 생각나는 ‘검은 화면(터미널)’이였다.
npm install이라는 외계어를 입력하며 겨우 설치에 성공했지만, 계정 연동부터 어떻게 쓰는지 하나도 모르겠어서 AI 스승님을 붙잡고 겨우겨우 실행에 옮겼다.

회사 계정을 연동 해야했는데, 개인 계정으로 연동이 되면서 pro나 Max계정이 아니면 사용 못한다고 뜨는데,,, 아무리 찾아봐도 로그아웃 버튼이 없어서 컴퓨터를 몇번이나 키고 끄고 무한 반복을 하게 되었다.

그러던 중, 클로드 코드는 브라우저처럼 메뉴가 따로 있는게 아닌 직접 명력어를 쳐야지만 로그아웃하고 다른 부분을 연동 할 수 있었다.
우리가 익숙하게 사용하는 로그인/로그아웃 같은 경우는 버튼을 만들어서 제공한 것이였고, 터미널에서는 /logout 이라는 명령어를 입력해야했다.

3. “내 코드가 어디 갔지?” 사라진 파일의 행방

가장 당황했던 순간은 /first-claude-code 같은 명령어를 입력했을 때였다.

상황: 클로드가 무언가 열심히 작업한 것 같은데, 터미널 창은 조용해졌다. 완료가 되었는지 안되었는지도 모른채 자동으로 막 써지던 코드가 멈췄다.
그래서 마지막에 묻는 코스가 “내 코드는 어디에 저장된 거지? 파일이 만들어지긴 한 건가?” 라는 류의 질문을 던졌다.
지금 생각해보면, 비싼 토큰을 무의미한 질문에 참으로도 많이 사용 한 것 같다.

깨달음: 비개발자 시각에서는 결과물이 눈에 보여야 하는데, CLI 환경은 그렇지 않았다. 터미널이 멈춘 게 아니라, 클로드는 이미 작업을 끝내고 제 명령을 기다리고 있었던 것이었고, AI한테 물어보니 ls 명령어로 파일 목록을 확인하거나, VS Code를 열어보고 나서야 클로드가 몰래(?) 만들어둔 소중한 코드들을 발견할 수 있었다.

4. 터미널에서 Git 연동하기: 개발자의 향기를 맡다

코드를 만들었으면 저장을 해야하는데, 작년에 컴퓨터공학을 공부하면서 조금 쓰던 깃허브에 저장이 하고 싶었다. 그러나 깃허브에 드래그 앤 드롭으로 파일을 업로드 하고 싶었는데… 파일을 업로드 하는 것 마저 너무 고난과 역경이였다.
그래서, 클로드 코드에 연동하고 자동으로 깃에 코드가 업데이트 될 수 있도록 작업이 필요했다.

시행착오: 평소라면 데스크톱 앱을 썼겠지만, 클로드 코드를 쓰는 김에 터미널로 도전해보고 싶었고, 하지만 일단 내 옆에는 여러명의 AI 스승님이 있어
모든 화면을 캡쳐 하면서 AI에게 보냈다.

변화: 클로드에게 “지금 만든 이 코드를 내 깃허브 저장소에 올려줘”라고 사람 말로 부탁하니, 클로드가 필요한 Git 명령어를 알려주고 실행까지 도와주었습니다. 비개발자가 ‘터미널 기반 워크플로우’를 경험하는 순간이었다.
근데, 이렇게 무의미하게 토큰을 써도 될까? 라는 궁금증이 있었는데 회사 개발자한테 이야기 해보니 그 것 만큼 편한 것이 없다며 잘 쓰고 있다고 했다

5. 클로드 코드 핵심 명령어 가이드 (비개발자용)

claude	실행	클로드를 깨우는 마법의 주문
/clear	화면 정리	대화가 너무 길어져 복잡할 때 청소하기
/logout	계정 로그아웃	계정 변경 할 때
/compact	기억력 회복	클로드가 앞 내용을 까먹기 시작할 때 요약해주기

6. 비개발자가 느낀 클로드 코드의 진짜 가점

단순히 코드를 짜주는 것을 넘어, “내 컴퓨터의 환경을 이해한다”는 점이 대단하게 느껴졌다.
그리고, 최근 많이 핫했던 OpenClaw는 진짜 내 컴퓨터 환경을 이해해서 자동으로 되는 것을 보니 ‘보이스피싱’같이 정보가 엄청 털릴 것 같아서 무섭기도 했다.

• 편리 했던 점은 내가 어떤 폴더에 있는지, 어떤 라이브러리가 설치되어 있는지 클로드가 다 알고 있으니 “에러 나요” 한마디만 하고 권한 허용만 해준다면 알아서 다 고쳐주었다.
• 복사-붙여넣기 과정에서 발생하는 ‘누락’ 사고가 없다는 것이 비개발자에게는 안도감을 주었다.

7. 완벽하지 않아도 괜찮아

회사에서는 비개발자 중에서 내가 제일 빨리 바이브 코딩에 몸을 담궜다.
다들 어떻게 시작 해야 할지 공부하고 시작한다고 했지만, 나는 이야기 했다. 일단 그냥 막 시작하는게 맞다! 라고
왜냐하면,

난 아직도 코딩을 잘 모른다.
하지만 클로드 코드 덕분에 검은 화면에 대고 일단 하고 싶을 것을 질문하면서 로컬 테스트 하면서 수정해나가는 재미가 있다. 사소한 로그인,로그아웃도 못하고 파일 위치를 몰라 헤매던 그 시간들이 결국은 ‘AI와 협업하는 법’을 익히는 과정이라고 생각을 하고 어제 보다 오늘 더 재미를 느끼고 있는 과정이니깐! 일단 실행하기!

이렇게 수 많은 화면을 캡쳐하면서 AI에게 바로바로 물어본다. 클로드, 제미나이, 퍼플렉, GPT 돌아가면서 다방면으로 물어보다보면 해결이 되면 마치 못풀고 있던 수학 문제를 잘 푸는 느낌이 든다.
(거의 1~2시간만에 매일 이렇게 배경화면이 꽉 찬다)