2LAZZZY 작업 노트2026-10-10 기준

조직 연결→API 키→Cline 연결→프로젝트에서 쓰기

Max API 크레딧, Cline으로 쓰기

Max와 Team 구독에 매달 붙는 API 크레딧을 받고, Cline CLI에 API 키로 연결해 내 프로젝트에서 쓰는 순서를 공식 문서 기준으로 정리했어요.

2026년 10월 7일 Anthropic이 Claude Haiku 5.5 발표 글에서 새로 밝힌 혜택이에요. 이 크레딧은 Claude 앱(데스크톱 포함)이나 대화형 Claude Code에는 안 쓰이고, 연결한 Console 조직의 API 키로 부르는 요청에만 쓰여요. Cline은 API 키로 붙는 도구라서, 키를 넣으면 터미널에서 대화하듯 내 프로젝트 일을 맡길 수 있어요.

안 쓴 크레딧은 결제 주기가 끝나면 사라져요(이월 없음). Cline의 --auto-approve는 파일 수정과 명령 실행을 묻지 않고 바로 해요.

이렇게 되면 성공이에요

1
크레딧 보임Console 설정 > 결제 > Promotional credits에 금액과 만료일이 떠요.
2
Cline 연결프로젝트 폴더에서 cline 을 치면 대화가 열리고, 아래 상태 줄에 고른 Claude 모델과 쓴 금액이 보여요.

한눈에 보는 진행 순서

Cline: 터미널에서 쓰는 코딩 에이전트

Cline 공식 소개 화면 (Automate, Understand, Refactor)

대상인지 확인
Max 5x, Max 20x, Team 플랜을 7일 이상 쓴 계정이에요.
자세히 보기 →
Console 조직 연결
claude.ai 설정 > 결제 > API 크레딧에서 연결해요.
자세히 보기 →
API 키 만들기
platform.claude.com에서 만들고 바로 복사해요.
자세히 보기 →
Cline 설치
```
npm install -g cline
```
Node.js 20 이상에서 npm으로 설치해요.
자세히 보기 →
API 키 연결
cline auth로 공급자, 키, 모델을 정해요.
자세히 보기 →
프로젝트에서 쓰기
프로젝트 폴더에서 cline 을 실행해요.
자세히 보기 →

누가, 얼마나 받나

플랜	매달 받는 크레딧
Max 5x	$100
Max 20x	$200
Team	Standard 좌석 $20, Premium 좌석 $100씩 합쳐 최대 $500
Free, Pro, Enterprise	대상 아님

플랜을 7일 이상 쓴 뒤부터 받을 수 있어요.

Pro 플랜은 이 월간 API 크레딧 대상이 아니에요. 다른 프로모션 크레딧을 받았더라도, Cline에 쓸 수 있는지는 Console의 설정 > 결제 > Promotional credits에 이 크레딧이 보이는지로 확인해요.

어디에 쓰이고, 어디엔 안 쓰이나

못 써요

Claude 앱(데스크톱 앱 포함)의 추가 사용량
대화형 Claude Code (터미널, IDE, 데스크톱, 웹)

써요

Claude API
Claude Agent SDK
Managed Agents
Console Playground

Cline은 Claude API에 API 키로 붙기 때문에 크레딧이 쓰여요. 연결한 Console 조직의 모든 API 키가 같은 잔액을 나눠 써요.

쓰지 않은 크레딧은 결제 주기가 끝나면 사라지고 다음 달로 넘어가지 않아요.

Console 조직 연결해서 받기

claude.ai를 웹 브라우저로 열기
설정 > 결제 > API 크레딧으로 가요. Team은 조직 설정 > 결제예요.
조직 연결 (Link organization)
크레딧을 받을 Console 조직을 골라요. 그 조직에서 Owner, Admin, Billing 역할 중 하나가 있어야 해요.
Console에서 확인
Console의 설정 > 결제 > Promotional credits에 금액과 만료일이 떠요.

연결할 수 있는 Console 조직은 하나예요. 연결한 뒤에는 직접 바꿀 수 없고 지원팀에 문의해야 해요.

API 키 만들기

platform.claude.com(Console)에서 연결한 조직의 API 키를 만들어요. 만든 화면에서 바로 복사해 두세요. 나중에 다시 볼 수 없어요.

키는 환경 변수에 넣어 두고 저장소에는 커밋하지 않아요.

export ANTHROPIC_API_KEY="YOUR_KEY"

프로젝트마다 쓰는 양을 막고 싶으면 Console에서 워크스페이스를 따로 만들고 지출 한도를 걸어요.

Cline CLI 설치

Node.js 20 이상이 필요해요(22 권장).

node -v
npm install -g cline

Cline에 API 키 연결

공식 CLI 레퍼런스의 예처럼 한 줄로 연결해요. -p는 공급자, -k는 API 키, -m은 모델이에요.

cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5

옵션 없이 치면 대화형 설정이 열려요.

cline auth

프로젝트에서 쓰기

프로젝트 폴더에서 실행하면 Cline이 파일을 읽고 명령까지 직접 돌려요.

명령	하는 일
cline	대화형으로 시작
cline "할 일"	한 번에 실행
cline -c /경로 "할 일"	작업할 폴더 지정
cline -p "계획"	계획 모드 (기본은 실행 모드)

cd my-project
cline "이 프로젝트 한번 분석해봐"

터미널에서 Cline에 프로젝트 분석을 맡긴 화면과 아래 상태 줄 — 실제 Cline CLI 화면: 위는 맡긴 일, 아래 상태 줄은 모델, 쓴 금액($0.34), Plan / Act

화면 아래 상태 줄에 쓰는 모델, 지금까지 쓴 금액, Plan / Act 모드가 보여요.

--auto-approve 를 붙이면 묻지 않고 파일을 고치고 명령을 바로 실행해요. 처음에는 빼고 쓰세요.

크레딧 아끼기

일에 맞는 모델 고르기
프롬프트 캐싱 쓰기
급하지 않은 일은 Batch API (50% 저렴)

크레딧이 다 떨어지면 다른 크레딧이 없을 때 API 요청이 멈춰요. Claude 플랜 요금으로 청구되지는 않아요.

자주 막히는 곳

증상	확인할 것
Credit balance too low	대화형 Claude Code를 이 조직의 키로 돌렸을 때 나와요. 대화형 Claude Code는 크레딧 대상이 아니에요.
키가 거부돼요	키 값, 공급자를 anthropic으로 골랐는지, 연결한 조직의 키인지 확인해요.

Cline 말고 claude -p로도 돼요

공식 도움말 FAQ(Does this cover claude -p?) 기준이에요.

크레딧 적용 안 돼요

Claude 플랜으로 로그인한 상태의 claude -p (플랜 한도에서 빠져요)
대화형 Claude Code, GitHub Action, IDE 확장, Claude 데스크톱 앱에서 시작한 실행 (-p를 붙여도 안 돼요)

크레딧 적용돼요

연결한 Console 조직의 API 키로 내가 직접 실행한 claude -p
Agent SDK 사용으로 청구돼요

API 키 지키기

같은 조직의 키는 모두 같은 크레딧 잔액을 써요. 키가 새면 남이 내 크레딧을 써 버릴 수 있어요.

키는 환경 변수에만 두고 저장소에 커밋하지 않기
프로젝트별 워크스페이스에 지출 한도 걸기
--auto-approve는 믿을 수 있는 폴더에서만

출처

크레딧 조건은 Claude 공식 문서와 도움말, Cline 명령은 Cline 공식 문서 기준이에요 (2026-10-10 확인).

2LAZZZY / 2026-10-10 기준. 이 페이지에는 실제 키나 로그인 정보가 없어요. 체크 표시는 이 기기에만 저장돼요.