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

# SDK 설치

> Node · TypeScript 프로젝트에 Nora 클라이언트 추가

Nora 클라이언트는 npm 패키지로 배포됩니다. TypeScript 우선(타입 포함), `fetch`와 `globalThis`를 지원하는 Node 18+ · Deno · Bun · 엣지 워커 어디서든 돕니다.

> [!NOTE]
>
> **상태 (2026-09-06)**: 리포에 구현·tsc 통과, 현재 `0.0.1`. 공용 npm scope로 게시가 진행 중입니다. 그때까지는 내부 레지스트리에서 설치합니다 (플랫폼 리포 접근 있으면 `packages/nora-agents` 소스를 vendor로 걸어 씀). API 계약은 안정적이라 공용 게시 시 install URL만 바꾸면 됩니다.

## 설치

```bash theme={null}
npm install @conscience-technology/nora-sdk
# 또는:
pnpm add @conscience-technology/nora-sdk
yarn add @conscience-technology/nora-sdk
```

## import

```ts theme={null}
import { createClient } from "@conscience-technology/nora-sdk";

const nora = createClient({
  tenant: "t_...",
  token: process.env.NORA_PAT,
  triggerSecret: process.env.NORA_TRIGGER_SECRET,
});
```

패키지 루트에서 노출되는 이름:

* `createClient(opts)` `NoraClient`를 반환하는 팩토리.
* `NoraClient` `new`로 직접 만들고 싶으면 클래스 자체.
* 타입: `ClientOptions`, `RunResult`, `Improvement`, `Change`, `Logger`, `LogEvent`.
* 에러 클래스: `NoraError`, `NoraAuthError`, `NoraRequestError`, `NoraAccessError`, `NoraProviderError`, `NoraPlatformError`. [에러](https://docs.nora.my/ko/sdk/errors.md) 참고.
* 트레이스 헬퍼: `traceRef`, `withTrace`, `currentTrace`, `injectHeaders`, `extractTrace`, `TRACE_HEADER`.

## 사전 조건

* **Node 18+** (또는 전역 `fetch` 있는 런타임). 폴리필 불필요.
* **ESM 전용**. 패키지가 `"type": "module"`로 배포됩니다. 프로젝트가 CommonJS면 dynamic `import()`를 쓰거나 진입점을 ESM으로 옮기세요.
* **서버 사이드 전용**. 브라우저에서 초기화하면 예외를 던집니다 (PAT · 트리거 시크릿 유출 방지). [개요 · 서버 사이드 전용](https://docs.nora.my/ko/sdk/overview.md#서버-사이드-전용) 참고.

## 버전 pin

프로덕션에서는 다시 설치해도 버전이 밀리지 않도록 정확한 버전을 고정하세요.

```json theme={null}
{
  "dependencies": {
    "@conscience-technology/nora-sdk": "0.0.1"
  }
}
```

업그레이드 때는 semver를 따르세요. 클라이언트 계약은 안정적이지만 옵션 모양은 minor 사이에 확장될 수 있습니다.

## 다음

* [Auth](https://docs.nora.my/ko/sdk/auth.md) PAT · 트리거 시크릿 발급과 스코프 선택.
* [클라이언트 옵션](https://docs.nora.my/ko/sdk/client-options.md) `ClientOptions` 전체 레퍼런스(baseUrl · 재시도 · 로깅 · 커스텀 fetch · …).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.