---
title: "API 키 발급 및 관리"
description: "1zheAI 콘솔에서 sk- 접두사 API 키를 생성하고, 저장·교체·유출 시 피해를 최소화하는 방법을 안내합니다."
headingIds: {"API 키 생성":"section-1","도구별 API 키 하나씩":"section-2","저장 위치":"section-3","유출되었을 때":"section-4","자주 묻는 질문":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

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

## API 키 생성

<Steps>
<Step title="콘솔 로그인">

[1zheai.com/console](https://1zheai.com/console?lng=ko)을 엽니다.

</Step>
<Step title="새로 만들기">

왼쪽 사이드바 메뉴에서 "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 범위에서의 호출만 허용 |

</Step>
<Step title="복사 및 저장">

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

</Step>
</Steps>

## 도구별 API 키 하나씩

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

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

## 저장 위치

<CodeGroup>
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
</CodeGroup>

<Warning>

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

</Warning>

## 유출되었을 때

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

## 자주 묻는 질문

<AccordionGroup>
<Accordion title="API 키를 Claude Code와 Cursor에 동시에 사용할 수 있나요?">

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

</Accordion>
<Accordion title="Invalid token / 401 표시는 API 키 문제인가요?">

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

</Accordion>
<Accordion title="API 키가 만료되나요?">

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

</Accordion>
</AccordionGroup>