API는 서로 다른 프로그램이 데이터를 주고받는 창구입니다. 내 도구가 네이버·Slack 같은 서비스에 데이터를 요청하면 서비스가 정해진 형식으로 응답을 돌려줍니다. 경쟁사 기사 모니터링은 네이버 검색 API, 마감 알림은 Slack API처럼, 사람이 일일이 하던 일을 프로그램이 대신하게 해주는 연결 통로입니다.

API 키는 어떻게 발급받나요?

각 서비스의 개발자 페이지에서 앱을 등록하면 발급됩니다. 개발자 센터에 로그인해 애플리케이션을 등록하고 사용할 기능을 선택하면 키가 나옵니다. 보통 Client ID와 Client Secret 한 쌍이거나 긴 토큰 하나이며, 이 키는 출입증이라 공개된 곳에 올리면 안 됩니다.

.env(환경변수)가 뭔가요?

.env는 환경변수를 모아 두는 설정 파일입니다. 환경변수(environment variable)란 코드 안에 직접 적지 않고 프로그램이 실행될 때 바깥 환경에서 읽어 오는 값으로, API 키처럼 비밀스럽거나 상황에 따라 달라지는 값을 코드와 분리해 둘 때 씁니다. 키를 코드에 박으면 공유·깃허브 업로드 시 유출되므로, 값을 .env에 환경변수로 빼두고 코드는 환경에서 읽어오게 만드는 것이 표준입니다. 한 줄에 하나씩 이름=값 형태로 적습니다.

.env는 어떻게 설정하나요?

프로젝트 폴더에 .env 파일을 만들어 NAVER_CLIENT_ID=값 형태로 키를 적고, .gitignore에 .env를 추가해 공유에서 제외합니다. 이렇게 하면 키는 내 컴퓨터에만 남고 코드를 공유해도 비밀 값은 빠집니다. 핵심은 키는 .env에, .env는 공유 금지입니다.

프롬프트로 내 입맛에 맞게 세팅하기

키 준비가 끝나면 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기면 됩니다. '원하는 결과 + 키는 .env에서 읽기'를 함께 적어 주면, AI가 .env에서 키를 읽어 API를 호출하는 코드를 만들어 줍니다. 코드를 직접 짜지 않아도 내 입맛에 맞는 자동화가 완성됩니다.

AI 일잘러 ① API 연결편: 코드 몰라도 외부 서비스 붙이기

AI에게 업무를 시키려면 먼저 외부 서비스를 연결하는 'API'를 붙여야 하며, 코드를 몰라도 다음 5단계로 가능하다. ① API 개념 이해 ② API 키 발급 ③ .env(환경변수) 이해 ④ .env 설정 ⑤ 프롬프트로 세팅이다. 핵심은 비밀 키를 안전하게 보관한 뒤, 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기는 것이다. 이번 1편에서 기초를 잡으면, 2편(기사 모니터링)부터 바로 써먹을 수 있다.

지금 이 5단계가 실무자에게 중요한 이유

예전에는 API 하나를 붙이려면 요청 문법, 인증 헤더, 응답 파싱을 직접 코드로 짜야 했다. 그래서 "연결"은 개발자의 영역이었고, 기획자·마케터는 개발자에게 요청서를 넘긴 뒤 며칠을 기다렸다. 지금 이 5단계가 의미 있는 이유는, 그 실행 부분(코드 작성)이 AI로 넘어갔기 때문이다. 실무자에게 남는 몫은 "키를 안전하게 준비하는 일"과 "무엇을 원하는지 정확히 말하는 일" 두 가지로 줄어든다. 코딩을 배우는 것이 아니라, 코딩을 위임하는 법을 배우는 셈이다.

API는 결국 '창구'다

API는 서로 다른 프로그램이 데이터를 주고받는 '창구'다. 식당에 비유하면, 주방(서비스)에 직접 들어가지 않고 점원(API)에게 주문하면 음식을 받아오는 것과 같다. 내 도구가 네이버·Slack 같은 서비스에 "이 데이터 줘"라고 요청하면, 서비스는 정해진 형식으로 응답을 돌려준다.

업무에서는 이렇게 쓰인다.

경쟁사 기사 모니터링을 하고 싶을 때 → 네이버 검색 API로 관련 기사를 자동 수집
업무 마감을 놓치기 싫을 때 → Slack API로 마감 알림을 자동 발송
매일 반복되는 데이터 수집을 자동화할 때 → 해당 서비스의 API 호출

즉 API는 "사람이 일일이 들어가서 복사하던 일"을 프로그램이 대신하게 해주는 연결 통로다. 검색·수집·알림처럼 규칙이 반복되는 일일수록 효과가 크고, 판단이 필요한 일은 여전히 사람 몫이라는 점을 기억하면 된다.

키 발급: 한 번의 '출입증' 만들기

API 키는 각 서비스의 개발자 센터에 로그인해 앱(애플리케이션)을 등록하고 쓸 기능을 선택하면 발급된다. 보통 Client ID와 Client Secret 한 쌍이거나 긴 문자열 토큰 하나로 나온다. 공통 절차는 다음과 같다.

해당 서비스의 개발자 센터에 로그인한다(예: 네이버 개발자 센터, Slack API 페이지).
'애플리케이션 등록' 또는 'Create App'을 눌러 앱을 만든다.
사용할 기능(예: 검색)을 선택하면 키(Key) 가 발급된다.

이 키가 곧 '출입증'이라, 노출되면 남이 내 권한으로 서비스를 쓸 수 있으니 절대 공개된 곳에 올리면 안 된다. 발급은 대개 한 번이면 끝나지만, 유출은 되돌리기 어렵다는 비대칭을 기억하는 것이 좋다.

왜 `.env`인가: 코드와 비밀을 분리하는 이유

.env는 '환경변수'를 모아 두는 설정 파일이다. 환경변수(environment variable)란 프로그램 코드 안에 직접 적지 않고, 프로그램이 실행될 때 바깥 환경에서 읽어 오는 값을 말한다. API 키처럼 비밀스럽거나, 개발용·운영용처럼 상황에 따라 달라지는 값을 코드와 분리해 두기 위해 쓴다.

키를 코드에 직접 박아 두면, 그 코드를 공유하거나 깃허브(GitHub)에 올리는 순간 키가 통째로 유출된다. 또 값이 바뀔 때마다 코드를 고쳐야 한다. 그래서 이런 값들을 .env 파일에 환경변수로 빼두고, 코드는 "환경에서 그 값을 읽어오게" 만드는 것이 표준 방식이다. 이는 개발자들이 오래전부터 지켜온 관행이지, ASAP이 새로 만든 규칙이 아니라는 점에서 안심하고 따라도 된다.

.env는 한 줄에 하나씩 이름=값 형태로 적는 단순한 텍스트 파일이며, 여기 적은 이름이 곧 코드가 불러 쓰는 환경변수의 이름이 된다.

실제 설정: 두 줄과 한 줄

프로젝트 폴더에 .env 파일을 만들어 한 줄에 하나씩 이름=값 형태로 키를 적고, .gitignore에 .env를 추가해 공유에서 제외하면 된다. 네이버 검색 API라면 NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET 두 줄을 넣는다.

NAVER_CLIENT_ID=발급받은_아이디
NAVER_CLIENT_SECRET=발급받은_시크릿

그리고 키가 실수로 업로드되지 않도록, .gitignore 파일에 다음 한 줄을 추가한다.

.env

이렇게 하면 키는 내 컴퓨터에만 남고, 코드를 공유해도 비밀 값은 빠진다. 핵심 원칙은 "키는 .env에, .env는 공유 금지"다.

코드 대신 프롬프트로 맡기기

키 준비가 끝나면, 실제 연결 코드는 Claude Code 같은 AI에게 프롬프트로 맡기면 된다. 코드를 직접 짜지 않아도, 무엇을 하고 싶은지 설명하면 AI가 .env에서 키를 읽어 API를 호출하는 코드를 만들어 준다. 예를 들어 이렇게 요청한다.

.env에 있는 NAVER_CLIENT_ID와 NAVER_CLIENT_SECRET을 사용해서
네이버 검색 API로 '버거킹' 관련 최신 기사 10건을 가져와 제목과 링크를 정리해줘.
키는 코드에 직접 쓰지 말고 .env에서 읽어와.

이처럼 "원하는 결과 + 키는 .env에서 읽기"를 함께 적어 주면, 내 입맛에 맞는 자동화가 완성된다.

ASAP의 관점: 한계와 남는 질문

이 방식의 진짜 장벽은 코드가 아니라 두 가지다. 첫째, 키를 다루는 순간 실무자도 최소한의 보안 감각이 필요하다. .env를 .gitignore에 넣는 습관 하나가 사고를 막는데, 이 습관은 코드보다 잊기 쉽다. 둘째, AI가 만든 코드가 무엇을 하는지 이해하지 못한 채 실행하면, 잘못된 요청이나 과도한 호출을 걸러낼 사람이 없어진다. 그래서 "코드를 몰라도 된다"는 말은 "결과를 검토하지 않아도 된다"는 뜻이 아니다. 무료 검색 호출에는 대개 일일 한도가 있고, 서비스마다 이용 약관이 다르다는 점도 실무 적용 전에 확인할 몫으로 남는다. 다음 2편에서는 이 방식을 그대로 써서 네이버 API로 경쟁사 기사 동향을 자동 정리하고 PPT로 내보내는 과정을 다룬다.

참고: 네이버 개발자 센터 · Claude Code 공식 문서