Claude Code·Codex API 키 사용 매뉴얼: 실제 화면으로 따라 하는 6단계 | DAKER 커뮤니티

Claude Code와 Codex는 구독 계정으로 로그인해 쓸 수도 있고, API 키로 연결해 쓴 만큼만 요금을 내는 방식으로 쓸 수도 있습니다. 이 매뉴얼은 2026년 10월 14일 실제 Claude Console·OpenAI Platform 화면과 맥북 터미널(Claude Code 2.1.296, Codex CLI 0.162.0) 화면을 순서대로 따라가며 API 키 방식 설정을 정리했습니다. 화면의 계정 정보·키·결제 정보는 가렸고, 빨간 번호는 눌러야 할 곳입니다.

시작 전에: 구독 로그인과 API 키의 차이

구독 로그인: Claude Pro·Max나 ChatGPT 플랜 계정으로 로그인하고, 플랜에 포함된 사용량 안에서 씁니다.
API 키: Claude Console이나 OpenAI Platform에서 만든 키로 연결하고, 쓴 토큰만큼 API 요금이 청구됩니다. 팀 공용 결제, 자동화, 사용량 관리가 필요할 때 알맞습니다.

1단계. Claude Console에서 API 키 만들기

Claude Console의 API 키 화면에 로그인한 뒤 오른쪽 위 ① 키 생성을 누릅니다. 키 이름과 워크스페이스를 고르면 키가 한 번만 표시되니 바로 안전한 곳에 복사해 둡니다.

Claude Console API 키 목록 화면, 오른쪽 위 키 생성 버튼에 빨간 상자와 번호 1 표시, 키·계정 정보는 가림 — ① 키 생성 버튼. 목록의 키 일부와 계정 정보는 가렸습니다.

Codex용 키는 OpenAI Platform의 API keys 화면에서 ① Create new secret key를 눌러 만듭니다. 이 키도 생성 직후 한 번만 보이니 바로 복사해 둡니다.

OpenAI Platform API keys 화면, Create new secret key 버튼에 빨간 상자와 번호 1, 키 이름·ID·작성자는 가림 — ① Create new secret key. 키 이름·ID·작성자는 가렸습니다.

2단계. 크레딧 충전과 결제 수단 등록

API 키는 크레딧이 있어야 작동합니다. Console의 조직 설정 > 결제 화면에서 ② 크레딧 구매로 충전하고, 아래쪽에서 결제 수단을 등록합니다. 화면 안내대로 자동 충전이 꺼져 있으면 잔액이 모두 소진될 때 API 요청이 중단되므로, 필요하면 자동 충전이나 지출 한도를 함께 설정합니다.

Claude Console 결제 화면, 크레딧 구매 버튼에 빨간 상자와 번호 2, 잔액·주소·카드 정보는 가림 — ② 크레딧 구매. 잔액·청구지·카드 정보는 가렸습니다.

OpenAI는 조직 설정 > Billing 화면에서 ② Add payment details로 결제 수단을 등록하고 크레딧을 충전합니다. 화면 안내처럼 API 크레딧은 ChatGPT 구독과 별개입니다. Usage limits에서 월 예산도 정할 수 있습니다.

OpenAI Platform Billing 화면, Add payment details 버튼에 빨간 상자와 번호 2, 잔액은 가림 — ② Add payment details. 잔액은 가렸습니다.

3단계. Claude Code를 API 키로 연결하기

터미널에서 로그인 옵션을 확인하면 --console이 "Anthropic Console (API usage billing)"로 나옵니다. 기본값 --claudeai는 구독 로그인입니다.

터미널에서 claude --version과 claude auth login --help를 실행한 실제 화면 — claude auth login --console이 API 과금 방식입니다.

Console 계정으로 로그인: claude auth login --console을 실행하고 브라우저에서 Console 계정으로 로그인합니다. 확인은 claude auth status입니다.
또는 환경 변수 사용: 1단계에서 만든 키를 export ANTHROPIC_API_KEY=키값으로 넣고 claude를 실행합니다. 공식 문서에 따르면 실행 시 키 사용을 승인하면 로그인 화면을 건너뜁니다.

설치·인증 전체 과정은 Claude Code 공식 문서의 설정 페이지에 있습니다.

4단계. Codex를 API 키로 연결하기

OpenAI 공식 문서는 Codex 로그인 방식을 ChatGPT 구독 로그인과 ④ API 키 로그인(사용량 기반) 두 가지로 안내합니다. API 키 사용량은 OpenAI Platform 계정에서 표준 API 요금으로 청구됩니다.

OpenAI Codex Authentication 문서, API 키 로그인 항목에 빨간 상자와 번호 4 — ④ Sign in with an API key for usage-based access

1·2단계에서 만든 OpenAI 키와 크레딧을 준비합니다.
export OPENAI_API_KEY=키값
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status로 확인합니다.

터미널에서 codex login --help를 실행해 --with-api-key 옵션이 보이는 실제 화면 — --with-api-key는 키를 stdin으로 받아 셸 기록에 키가 남지 않습니다.

기본 모델은 ~/.codex/config.toml의 model 줄로 정합니다.

codex --version과 config.toml의 model 줄을 보여 주는 실제 터미널 화면 — config.toml의 model, model_reasoning_effort 설정

5단계. 사용량 확인하기

Claude Console의 사용량 화면에서 ③ 범위를 바꿔 기간별 입력·출력 토큰과 모델별 사용량을 봅니다. 화면 안내처럼 최근 사용량은 반영까지 약 30분이 걸릴 수 있습니다. OpenAI는 Platform의 Usage 화면에서 ③ 기간 필터(Last 7 days 등)를 바꿔 확인하고, 단가는 OpenAI API 가격 페이지를 기준으로 합니다.

Claude Console 사용량 화면, 범위 필터에 빨간 상자와 번호 3 — ③ 범위 필터로 기간을 바꿉니다.

OpenAI Platform Usage 화면, 기간 필터 Last 7 days에 빨간 상자와 번호 3, 지출 금액은 가림 — ③ OpenAI Usage의 기간 필터. 지출 금액은 가렸습니다.

6단계. 보안 수칙과 문제 해결

키를 코드, 깃 저장소, 스크린샷, 채팅에 붙여 넣지 않습니다. .env는 .gitignore에 넣습니다.
용도별로 키를 나누고, 쓰지 않는 키는 Console·Platform에서 바로 삭제합니다. 노출이 의심되면 즉시 폐기하고 새로 만듭니다.
구독으로 쓰는데 API 요금이 나갈 때: 셸에 ANTHROPIC_API_KEY나 OPENAI_API_KEY가 남아 있는지 env | grep API_KEY로 확인합니다. Claude Code 공식 문서도 키 없이 로그인하려면 먼저 unset ANTHROPIC_API_KEY를 하라고 안내합니다.
인증 오류가 날 때: 키가 삭제됐거나 크레딧·결제 수단이 없는 경우가 많습니다. 1·2단계 화면에서 키 상태와 잔액을 확인합니다.
방식을 바꿀 때: Claude Code는 claude auth logout 후 다시 로그인하고, Codex는 codex logout 후 다시 로그인합니다.

출처

Claude Code 공식 문서: Advanced setup
Claude Code 공식 문서: 인증과 권한(IAM)
OpenAI Codex 공식 문서: Authentication
OpenAI Codex 공식 문서: CLI
실제 화면: 2026년 10월 14일 Claude Console·OpenAI Platform(API 키·결제·사용량)과 macOS 터미널 실행 결과