> ## 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.

# nora models

> 이 워크스페이스가 실제로 고를 수 있는 LLM 모델 나열. BYOK 필터

`models` 명령이 agent 빌더가 이 워크스페이스에서 고를 수 있게 허용한 LLM을 보여줌. 앱과 같은 필터를 씀. 키가 설정된([`nora providers`](/ko/cli/providers)로) provider만 목록에 모델을 보탬.

Provider 키를 설정하면 목록이 자람. 새 것은 없음. 모든 워크스페이스가 같은 카탈로그를 봄.

## 명령

| 명령                     | 설명                 |
| ---------------------- | ------------------ |
| `models list [--json]` | 쓸 수 있는 모델 카탈로그 출력. |

## `models list`

```bash theme={null}
nora models list
```

쓸 수 있는 모델마다 한 줄씩 출력. 모델 이름, provider, env-var 이름, 있으면 커스텀 API base URL.

전체 응답(모델별 capability blob 포함)은 `--json`을 붙임:

```bash theme={null}
nora models list --json | jq '.models[] | {model, provider, capabilities}'
```

다른 스크립트나 LLM으로 파이프할 때 좋음.

## 빈 목록

명령이 "no models available" 을 출력하면 아직 provider 키가 없음:

```bash theme={null}
nora providers set openai --stdin < ~/.secrets/openai
nora models list
```

BYOK 필터는 서버 쪽에서 강제됨. agent 빌더에서 키 없는 provider를 숨기는 것과 같은 룰.

## 커스텀 OpenAI 호환 엔드포인트

Provider가 커스텀 `api_base`(셀프 호스트 vLLM, LM Studio, OpenAI 호환 프록시)로 설정되면, 추가 컬럼이 base URL을 표시해 호스팅과 셀프 호스트를 한눈에 구분.

## 관련

* [`nora providers`](/ko/cli/providers)이 목록을 채우는 키 설정.
* [`nora agents update --set-model`](/ko/cli/agents) Agent에 모델 고르기.
* [Providers (Settings)](/ko/settings/models/providers) 개념 문서.