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

# base44 exec

> 現在のユーザーとして事前認証された Base44 SDK でスクリプトを実行します。スクリプトは stdin から読み取ります。

<Warning>
  このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは [デベロッパードキュメント](/developers) を参照してください。
</Warning>

# base44 exec

現在のユーザーとして事前認証された Base44 SDK でスクリプトを実行します。スクリプトは stdin から読み取ります。

## 構文

```bash theme={null}
cat ./script.ts | npx base44 exec
echo "<code>" | npx base44 exec
```

## 動作の仕組み

`exec` コマンドは stdin からスクリプトを読み取り、現在ログインしているユーザーとして事前認証された Base44 SDK でサーバー側で実行します。これにより、完全な関数を書かずにアプリのデータに対してワンオフのスクリプトを実行できます。

## 利用可能なグローバル

> **`base44`** — 事前初期化された SDK クライアントで、すべての exec スクリプトでグローバル変数として利用可能です。インポートや設定は不要で、すぐに使用できます。

これを使ってアプリのリソースと対話します:

* `base44.entities.<EntityName>` — エンティティの CRUD 操作 (`.list()`, `.get(id)`, `.create(data)`, `.update(id, data)`, `.delete(id)`)
* `base44.functions.invoke(name, data?)` — バックエンド関数を呼び出す
* `base44.agents.<AgentName>` — AI エージェントを呼び出す
* 利用可能なその他のリソースとメソッドについては、[Base44 SDK リファレンス](https://docs.base44.com/developers/skills/base44-cli/references/../../base44-sdk/SKILL.md) を参照してください

## 例

```bash theme={null}
# Run a script file
cat ./script.ts | npx base44 exec

# Inline script
echo "const users = await base44.entities.User.list(); console.log(users)" | npx base44 exec

# Run against a specific app without a local project checkout
cat ./script.ts | npx base44 exec --app-id app_123

# Or resolve the app from the environment
BASE44_APP_ID=app_123 npx base44 exec < ./script.ts
```

## 要件

* 認証済みである必要があります (`npx base44 login`)
* 以下のいずれかのコンテキストで実行する必要があります:
  * リンクされた Base44 プロジェクトディレクトリから、または
  * `--app-id <id>` を指定、または
  * `BASE44_APP_ID` を設定
* スクリプトは stdin 経由でパイプする必要があります (非対話モード)

## 注意事項

* スクリプトは Base44 SDK が事前認証された状態で実行されます — `base44.entities`、`base44.functions` などを直接使用できます
* `--app-id` は、リンクされたローカルプロジェクトに切り替えずにアプリデータを検査したい場合に便利です
* スクリプトの終了コードは CLI プロセスの終了コードとして転送されます
* このコマンドは stdin をパイプする必要があります (対話型 TTY モードでは入力を受け付けません)

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>