> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Providers

> LLM 제공자 API 키를 관리합니다. OpenAI, Anthropic, Google 등

Agent는 외부 제공자(OpenAI, Anthropic, Google) 모델과 Nora 관리 모델 티어로 돕니다. Agent가 부르는 제공자마다 워크스페이스 수준 API 키가 필요합니다.

## 키가 사는 곳

* **워크스페이스 스코프** 키는 사용자별이 아니라 워크스페이스별입니다.
* **저장 시 암호화** UI나 API로 절대 안 돌아옵니다. 앱이 키를 다시 못 읽습니다.
* **워크스페이스별 사용량 귀속** 키를 워크스페이스별로 두면 제공자 대시보드에서 비용이 깔끔하게 나뉩니다.

## 키 더하기

**Settings → Models → Providers → Add key** 입니다.

1. 제공자를 고릅니다(OpenAI, Anthropic, Google, …).
2. 키를 붙입니다. 입력이 가려집니다.
3. 저장합니다.

또는 CLI 로요.

```bash theme={null}
nora providers set openai --stdin <<< "$OPENAI_API_KEY"
```

CLI 세부는 [`nora providers`](/ko/cli/providers)를 참고하세요.

## Nora가 지원하는 제공자

* **OpenAI** GPT 모델.
* **Anthropic** Claude 모델.
* **Google** Gemini 모델.
* **Nora managed** Nora가 호스팅하는 모델(외부 키가 필요 없습니다. Nora가 결제합니다).

제공자가 계속 늘어납니다. 앱의 providers 목록이 지금 목록을 보여줍니다.

## 키 로테이션

새 값으로 키를 다시 더합니다. 이전 키가 한 번에 바뀝니다.

* 새 실행이 곧바로 새 키를 씁니다.
* 돌던 실행은 이전 키에서 끝냅니다(네트워크가 안정될 때까지 최대 1분).

몇 분에 걸쳐 auth 실패를 보며 확인합니다.

```bash theme={null}
nora traces list --status error --search "authentication" --limit 10
```

## 키 삭제

키를 지웁니다. 그 제공자를 쓰는 Agent는 새 키를 정할 때까지 다음 실행이 실패합니다.

## Provider 준비 점검

Flow를 배포하기 전, 모든 모델에 provider 키가 있는지 확인합니다.

```bash theme={null}
nora providers check support-agent
```

이런 표를 찍습니다.

```
Flow: support-agent
  openai:    ✓ configured  (Agent 3개 사용)
  anthropic: ✗ MISSING     (Agent 1개 사용: ag_secondary)
```

CI가 이 점검으로 배포를 막을 수 있습니다.

## Provider 키와 Nora 관리 모델

* **Provider 키** 여러분이 제공자에게 직접, 그들 미터로 결제합니다.
* **Nora 관리** Nora가 모델을 호스팅하고 Nora 인보이스로 결제합니다. 결제가 더 간단하고 가끔 더 쌉니다.

\*\*`--set-model`\*\*로 Agent 블록마다 고릅니다([`nora agents`](/ko/cli/agents) 참고). 마음껏 섞으세요. 한 Flow가 같은 실행에서 provider 모델과 관리 모델을 함께 쓸 수 있습니다.

## 요율 제한과 쿼터

Provider 요율 제한이 걸립니다. Agent가 부하에서 429를 받으면 이렇게 하세요.

* Provider 티어를 올립니다(OpenAI의 Tier 4, Anthropic의 Enterprise 등).
* Agent 별 폴백 모델을 더합니다([`nora agents update --set-model`](/ko/cli/agents) 참고). Agent가 실패하면 매끄럽게 넘어갑니다.
* 의도별로 라우팅합니다. 싼 의도는 싼 모델, 어려운 의도는 프리미엄 모델로요.

Nora는 provider 위에 자체 요율 제한을 더하지 않습니다.

## 비용 대시보드

Provider 비용은 provider 자체 대시보드(OpenAI, Anthropic, Google)에 뜹니다. Nora의 결제 화면은 Nora 플랫폼 비용을 다룹니다. [결제 개요](/ko/settings/billing/overview)를 참고하세요.

키가 워크스페이스별이라 provider 대시보드에서 워크스페이스별 비용이 쉽게 나뉩니다.

## 보안

* 키가 워크스페이스별 키로 암호화되어 저장됩니다.
* 로테이션은 즉시입니다.
* 삭제는 영구입니다(키가 안 남습니다).
* 모든 추가·로테이션·삭제가 감사됩니다.

## 관련

* [`nora providers`](/ko/cli/providers) CLI 레퍼런스.
* [모델 기본값](/ko/settings/models/defaults) 워크스페이스 전체 모델 선호.
* [결제 개요](/ko/settings/billing/overview) Nora 플랫폼 결제.
* [승인](/ko/reliable/optimization/approve) 승인 게이트가 설정되면 모델 스왑을 막을 수 있습니다.