API 키 발급 및 관리

1zheAI 콘솔에서 sk- 접두사 API 키를 생성하고, 저장·교체·유출 시 피해를 최소화하는 방법을 안내합니다.

API 키는 하나의 호출 권한 세트에 대응하며, 요금은 계정 잔액에서 차감됩니다. 이 페이지에서는 API 키 생성 방법, 저장 위치, 문제가 발생했을 때의 대처 방법을 설명합니다.

API 키 생성

콘솔 로그인
1zheai.com/console을 엽니다.

새로 만들기

왼쪽 사이드바 메뉴에서 “API Keys”를 클릭한 뒤, 오른쪽 위의 “Create API Key”를 클릭합니다. 용도가 드러나는 이름을 입력합니다. 예: claude-code-macbook, ci-staging. 다른 항목은 기본값으로 두어도 정상적으로 동작합니다. “Save Changes”를 클릭합니다.

양식에서 설정할 수 있는 항목:

양식 항목	기본값	설명
이름	비어 있음	호출 로그에서 API 키를 구분하는 데 사용
만료	만료 없음	1시간, 1일, 1개월 중에서 선택하거나 정확한 날짜와 시각을 지정
수량	1	한 번에 여러 개 생성; 이름에 무작위 접미사가 자동 추가됨
“Unlimited Quota” 토글	켜짐	끄면 “Quota (USD)” 항목이 나타나며, 이 API 키는 최대 해당 USD만큼만 사용할 수 있음
모델 제한(“Advanced Settings” 아래)	비어 있음, 즉 모든 모델 허용	모델을 선택하면 이 API 키는 해당 모델만 호출할 수 있음
IP 허용 목록(“Advanced Settings” 아래)	비어 있음, 즉 제한 없음	목록에 등록된 IP 또는 CIDR 범위에서의 호출만 허용

복사 및 저장
API 키는 sk-로 시작합니다. 복사한 뒤 비밀번호 관리자나 환경 변수에 넣고, 채팅·스크린샷·코드 저장소에 붙여넣지 마세요.

도구별 API 키 하나씩

도구별, 기계별로 API 키를 따로 만드는 것을 권장합니다. 세 가지 이점이 있습니다.

호출 로그가 API 키별로 분리되어, 어느 도구가 얼마를 썼는지 한눈에 파악할 수 있습니다.
API 키 하나가 유출되면 해당 키만 삭제하면 되므로 다른 도구에 영향이 없습니다.
팀에서는 각자가 자신의 API 키를 책임지고, 구성원이 퇴사하거나 기계를 바꿀 때 해당 키를 삭제합니다.

저장 위치

# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"

[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效

# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key

Claude Code의 프로젝트 수준 .claude/settings.json은 보통 저장소에 커밋되며, Claude Code 공식 문서는 여기에 자격 증명을 쓰지 말 것을 명시적으로 권고합니다. API 키는 사용자 수준의 ~/.claude/settings.json에 넣거나, 커밋되지 않는 프로젝트 내 .claude/settings.local.json에 넣으세요.

유출되었을 때

“API Keys” 목록에서 해당 키를 찾아 “Actions” 열의 “Disable” 아이콘을 클릭하거나, ”⋯” 메뉴에서 “Delete”를 선택합니다. 비활성화하면 즉시 적용되어, 이후 해당 키로의 호출은 401 Invalid token을 반환합니다.
새 API 키를 생성하고, 이전 키를 사용하던 모든 곳에 교체합니다.
호출 로그(콘솔 메뉴 “Call Logs”)를 열고 “Expand”를 클릭한 뒤, “Token Name”에 이 API 키의 이름을 입력해 필터링하여 최근 호출 중 본인이 시작하지 않은 것이 있는지 확인합니다.

자주 묻는 질문

API 키를 Claude Code와 Cursor에 동시에 사용할 수 있나요?

네, API 키는 도구에 종속되지 않습니다. 다만 섞어 쓰면 로그에서 누가 돈을 썼는지 불분명해지므로, 따로 만드는 것을 권장합니다.

Invalid token / 401 표시는 API 키 문제인가요?

대부분 그렇습니다. 흔한 원인은 다음과 같습니다. 키와 함께 공백이나 줄바꿈이 복사된 경우, API 키가 이미 삭제된 경우, 도구에서 잘못된 항목에 입력한 경우입니다. 단계별 점검 방법은 오류 코드 및 문제 해결을 참조하세요.

API 키가 만료되나요?

기본적으로 만료되지 않습니다. 생성하거나 편집할 때 “Expiration”에 시각을 설정할 수 있으며, 만료 후에는 호출이 401 Invalid token을 반환합니다. 이는 API 키를 잘못 입력했을 때와 동일한 응답입니다. 목록의 “Expiration” 열에 각 API 키의 만료 시각이 표시됩니다.