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

> `npm install box`の内容、バンドルされているSDKとCLIの使用方法、既存の`box-node-sdk`ユーザーが知っておく必要のある情報について説明します。

# `box` npmパッケージ

npmの`box`パッケージは[Box Node SDK](/guides/tooling/sdks/node)と[Box CLI](/guides/cli)を一度にインストールできるようにバンドルしたものです。これを使うと、JavaScriptプロジェクトまたはTypeScriptプロジェクトへのBoxの追加や、Box CLIコマンドの実行が1つのコマンドでできます。

## 含まれる内容

`npm install box`は以下の2つの直接的な依存関係をインストールします。

* **Box Node SDK**。`box/sdk`サブパスから利用できます。
* **Box CLI**。`npx box`を通じて利用できます。

TypeScriptの型が含まれています。

## 前提条件

[Node.js](https://nodejs.org/) 22以降のインストール。

## インストール

```bash theme={null}
npm install box
```

このパッケージは、npm、yarn、pnpm、bunで機能します。

## SDKの利用

SDKを`box/sdk`サブパスからインポートします。

```javascript theme={null}
import BoxSDK from 'box/sdk';  // ESM
const BoxSDK = require('box/sdk');  // CommonJS
```

SDKの利用と認証については、[Node SDKのインストール](/guides/tooling/sdks/node)と[認証ガイド](/guides/authentication/select)を参照してください。

<Info>
  **安定したエイリアス。**SDKは`import BoxSDK from 'box'`を使ってパッケージのルートからインポートすることもできます。これは同じSDKを返し、基になるパッケージが将来変更されても安定して維持されるようになっています。
</Info>

## CLIの利用

`npx box`で任意のCLIコマンドを実行します。

```bash theme={null}
npx box --help
npx box login
npx box users:get me
```

CLIを別途インストールする必要はありません。CLIの詳細なドキュメントについては、[CLIの概要](/guides/cli)を参照してください。

## 継続的統合 (CI)

このパッケージはCI環境でも安全に使用できます。以下のいずれかを満たしている場合は、インストール後メッセージがスキップされます。

* `CI`環境変数が`true`に設定されている。
* `SUPPRESS_BOX_INSTALL_MESSAGE`環境変数が設定されている。
* `--ignore-scripts`を指定してインストールを実行する。

インストール中およびインストール後にネットワークリクエストは行われません。Box APIトラフィックはすべて、Box SDKとCLIを通じて、実行時にアプリケーションの認証の使用で発生します。

## セキュリティ

どのリリースにも、公式GitHubリポジトリに照らして検証できる、暗号技術による来歴証明が含まれています。

## ブラウザパッケージではない

`box`パッケージはNode.js用です。Box UIコンポーネントをブラウザアプリケーションに埋め込むには、[`box-ui-elements`](/guides/embed/ui-elements)を別途インストールします。

## 既存の`box-node-sdk`ユーザー

移行は必要ありません。`box-node-sdk`で問題なければ、そのまま使用してください。`box`パッケージは、新しく始める開発者とそのコーディングエージェント向けです。既存のコードに影響はありません。

## オープンソース

`box`パッケージはApache 2.0ライセンスに基づき、オープンソースとして[github.com/box/npm-box](https://github.com/box/npm-box)で公開されています。コントリビューションはこのリポジトリに対するプルリクエストを通じて取り込まれます。