1. 비개발자가 클로드 코드(Claude Code)에 도전하는 이유
AI 코딩 도구의 발전으로 코딩을 전혀 모르는 비개발자들도 자신만의 서비스를 만들거나 업무 자동화를 시도하고 있다.
그 중에 앤스로픽(Anthropic)에서 출시한 클로드 코드(Claude Code)는 강력한 성능으로 큰 주목을 받고 있고, MS 내부에서도 클로드 코드(Claude Code)로 작업을 많이 한다고 알려지면서 더 인기가 많아졌다.
하지만 터미널(Terminal)이라는 검은 화면을 마주하는 순간, 비개발자들은 첫 번째 장벽에 부딪힌다. VScode도 있고 인텔리J도 있지만 터미널이 어떤 것도 설치하지 않고 ‘딸깍’ 하는 순간에 설치 해주는 프로세스를 태워주기 때문에 먼저 터미널에 계속 도전하고 있다.
이 앞에 글에서도 이야기 했지만, 매 번 이런 기본적인 것들이 헷갈려 같은 날에도 몇 번씩 AI에게 물어보게 된다.
“로그아웃은 어떻게 하지?”, “API 키는 어디에 입력해?”, “왜 자꾸 영어로 에러가 뜨지?”
2. 클로드 코드 로그아웃(Logout), 왜 안 될까?
처음에 바보 같이 클로드를 먼저 빠져나와서 로그아웃 하는 방법과 클로드 코드 안에서 로그아웃 하는 방법 여러가지가 너무 헷갈렸다.
클로드 코드 현재 로그인 되어있는 것을 로그아웃 하기 위해서는 클로드 코드 안에서 로그아웃으로 해야했고,
클로드 전체 계정을 다른 것으로 바꾸려면 초기 세팅을 다시 하려면 Ctrl + C눌러 클로드 코드를 빠져나와서 실행해야했다.
ㄱ. 채팅창과 터미널을 구분하기
해결책: 반드시
Ctrl + C를 눌러 프로그램을 완전히 빠져나온 뒤, 맥(Mac) 기본 터미널 프롬프트(%모양) 상태에서 명령어를 입력해야 합니다.핵심 명령어:
claude logout
ㄴ. 보안상의 이유
클로드는 보안 때문에 스스로 로그아웃 버튼을 대신 눌러줄 수 없다고 한다. 완전 초기에는 “클로드 로그아웃 해 줘”라고 가감없이 이야기 했더니 자기는 로그아웃을 할 수 없다고 했다.
사용자가 직접 “내가 이 계정에서 나갈게”라고 명령어를 쳐야만 인증 정보가 삭제되고, 만약 로그아웃이 무한 반복된다면, 프로그램이 켜져 있는 상태는 아닌지 먼저 확인보아야 한다
여기서도 처음에 헷갈렸다.
1. 데스크탑 클로드 로그아웃 2. 웹 클로드 로그아웃
이 2가지도 동시에 해야지 그렇지 않으면, 기존에 로그인 했던 기록을 기억해서 로그아웃을 했어도 자동으로 로그인이 되는 경우가 있어서 너무 당황했었다.
3. 개인 API 키(API Key) 설정
요금제에는 여러 종류가 있는데, 정액제의 경우 아이디에 할당량을 주고 쓰는 방식과 쓴 만큼만 내는 방식이 있다.
API같은 경우는 쓴 만큼만 내는 방식이라서 해당 방법을 채택했다.
ㄱ. API 키 발급받기
먼저 Anthropic Console에 접속하여 sk-ant-api03-...으로 시작하는 API 키를 발급받아야 한다.
이때 주의할 점은 반드시 Credit(잔액)이 충전되어 있어야 하며, 최소 5달러 이상 충전되지 않은 키는 등록해도 Invalid API key라는 빨간색 에러를 뿜어낸다.
ㄴ. 맥(Mac) 터미널 환경 변수 등록
매번 키를 입력하기 귀찮다면 맥의 설정 파일인 .zshrc에 키를 저장해야 한다.
1. 터미널을 연다
2.open -e ~/.zshrc를 입력해 메모장처럼 파일을 연다.
3. 맨 아랫줄에export ANTHROPIC_API_KEY="발급받은 API_키를 여기다가 넣어야함"를 추가한다.
4. 저장 후 터미널에source ~/.zshrc를 입력해 적용한다.
4. “Auth Conflict” 주황색 경고 문구 해결하기
설치를 잘 마쳤는데 실행할 때마다 주황색으로 “Auth conflict: Using ANTHROPIC_API_KEY instead of Anthropic Console key”라는 긴 문구가 뜰때가 있다.
ㄱ. 경고의 의미
: 이건 에러가 아니라고 한다, “너 지금 웹 로그인 정보(토큰)도 있고 API 키도 있는데, 나는 네가 등록한 API 키를 우선해서 쓸게!”라고 알려주는 친절한 안내문이라고 한다.
ㄴ. /logout 내부 명령어 사용
: 클로드 코드를 실행한 상태(> 프롬프트)에서 채팅창에 직접 /logout을 입력하세요. 그러면 웹 세션 토큰을 지울 수 있습니다. 그 후 다시 실행하면 환경 변수로 설정한 API 키만 남게 되어 경고 문구가 사라진다.
[TIP] 근데도 해결 되지 않는다면, 내 블로그 글의 키헬퍼 방법으로 해야한다
5. 비개발자가 겪는 핵심 오류 해결 리스트 (FAQ)
Q1.
Invalid API key라고 빨간색 글씨가 떠요.
해결책:echo "[$ANTHROPIC_API_KEY]"를 입력해 대괄호 안에 빈칸이 없는지 확인하고, 앤스로픽 콘솔에서 결제 상태 확인하기
원인 1: API 키 복사 시 앞뒤에 공백이나 따옴표가 중복으로 들어갔을 가능성.
원인 2: 계정에 충전된 잔액(Credit)이 0달러인 경우.
Q2.
command not found: claude라고 나와요.
해결책:.zshrc파일에export PATH="$HOME/.local/bin:$PATH"를 추가해 줘야 합니다.
원인: 컴퓨터가 클로드 프로그램이 어디 설치되어 있는지 경로(PATH)를 모르는 상태입니다.
Q3. 프로젝트 폴더를 어떻게 읽게 하나요?
해결책: 반드시cd 폴더경로명령어를 통해 내 코드가 들어있는 폴더로 이동한 뒤claude를 실행해야 합니다.
원인: 홈 디렉토리(~)에서 실행하면 클로드가 내 코드를 찾지 못합니다.
6. 클로드 코드는 비개발자의 가장 강력한 무기
처음에는 터미널 환경이 낯설고 명령어를 입력하는 것이 무서울 수 있다.
하지만 한 번 제대로 세팅해 두면, 클로드 코드는 내 프로젝트의 모든 파일을 읽고 분석하여 “이 부분 고쳐줘”, “새로운 기능을 추가해줘”라는 요청을 완벽하게 수행 할 수 있는 동반자로 함께 할 수 있다.
비개발자 여러분, Invalid API key나 Auth conflict 같은 영어 메시지에 겁먹지 마세요. 오늘 설명해 드린 단계를 하나씩 따라가다 보면 어느새 AI와 함께 코딩하는 즐거움을 느끼게 될 것이다.