--- title: "Catalyst CLI" url: https://docs.catalyst.zoho.com/ja/faq/cli/ description: "このセクションでは、Catalyst CLIのインストール、すべてのサービスで利用可能なさまざまなCLIコマンド、コマンド実行時のエラーやバグの解決方法などに関するよくある質問をご案内します。" last_updated: 2026-08-17T12:16:04Z service: All Services type: faq --- # 一般 ### Catalyst CLIの使い方を教えてください。 Catalyst CLIのインストールについては、[**Catalyst CLIのインストールヘルプページ**](https://docs.catalyst.zoho.com/ja/getting-started/installing-catalyst-cli)を参照してください。 npmコマンドを使用してCatalyst CLIをインストールした後、ターミナルからCLIを操作できます。Catalystコマンドはキーワードcatalystで始まります。すべてのCLIコマンドの詳細については、[**CLIドキュメント**](https://docs.catalyst.zoho.com/ja/cli/v1/cli-command-reference/)を参照してください。 ### Catalyst CLIのアップデートがあることをどのように知ることができますか？ Catalyst CLIの新しいバージョンが利用可能な場合、CLIコマンドを正常に実行した後にターミナルにアラートメッセージが表示されます。 ![catalyst_faq_cli_update](https://catalyst-docs-development.zohostratus.in/images/faq/catalyst-cli/catalyst_faq_cli_update.webp) CLIを更新するには、以下のコマンドを実行します： ```sh $ npm install -g zcatalyst-cli ``` > **注意：** - まれに、システムのレジストリ値がCatalyst CLIの最新バージョンを反映しない場合があります。その場合、システムが古いバージョンのCLIを保持する可能性があります。これを回避するには、コマンド実行時にバージョン番号を指定してください。例えば、バージョン1.14.1に更新するには $ npm install -g zcatalyst-cli @1.14.1 を実行します。 - Catalyst CLIを更新できない場合は、`sudo`を使用してコマンドを実行してください。 または、[NPMウェブサイト](https://www.npmjs.com/package/zcatalyst-cli)にアクセスして、最新バージョンを使用しているか確認できます。 ### Catalyst CLIの問題を報告するにはどうすればよいですか？ CLIで問題や異常な動作が検出された場合、Catalystはコマンドが実行されたディレクトリに自動的に`catalyst-debug.log`ファイルを作成します。その後、サポートメールアドレス[**support@zohocatalyst.com**](mailto:support@zohocatalyst.com)を通じてCatalystチームにお問い合わせいただけます。 問題の簡単な説明を記載し、メールに`catalyst-debug.log`ファイルを添付してください。Catalystチームが24時間以内に問題の解決策をご連絡いたします。 ### CLIで'Catalyst command not found'エラーが発生するのはなぜですか？ Catalyst CLIがローカルシステムに正しくインストールされていない場合、このエラーが発生する可能性があります。このエラーを修正するには、以下の手順を試してください： 1. ターミナルで`node -v`コマンドを実行して、最新の安定版Nodeバージョンがインストールされているか、またv12より大きいかを確認する必要があります。 2. ターミナルで`npm -v`コマンドを実行して、NPMバージョンがv12より大きいかも確認する必要があります。 3. Catalyst CLIをアンインストールし、macOSでは`sudo`コマンドを使用して、またはWindowsでは管理者モードのコマンドプロンプトで[Catalyst CLIを再インストール](https://docs.catalyst.zoho.com/ja/getting-started/installing-catalyst-cli)してください。 ### Catalyst CLIコマンドの実行中に'SyntaxError: Unexpected token'エラーを解決するにはどうすればよいですか？ Catalyst CLIは**Node.js v12以降**のみをサポートしています。このエラーが発生した場合、システムにインストールされているNode.jsのバージョンが古い可能性があります。 このエラーを解決するには、[公式ウェブサイト](https://nodejs.org/ja/download)からプラットフォーム用のNode.js v12以降をダウンロードしてNode.jsバージョンを更新するか、NVMなどのNodeバージョンマネージャーを使用してNode.jsとNPMをインストールします。NPMはNode.jsのインストール時にバンドルされています。Node.jsが正常に更新されたか確認するには、ターミナルで以下のコマンドを実行してバージョンを確認します： ```sh $ node -v ``` ### Catalystコマンドの実行時に'Unable to get local issuer certificate'エラーを解決するにはどうすればよいですか？ システムで厳密なTLS認証が有効になっている場合、このエラーが発生します。ターミナルで以下のコマンドを実行することでこのエラーを解決できます： ```sh $ set NODE_TLS_REJECT_UNAUTHORIZED=0 ``` これでCatalystコマンドの再実行を試すことができます。問題が解決しない場合は、[**support@zohocatalyst.com**](mailto:support@zohocatalyst.com)のCatalystサポートにお問い合わせください。 ### 'JavaioInvoker has been compiled by a more recent version of the Java runtime'エラーを解決するにはどうすればよいですか？ CLIは実行時にJavaクラスのみをコンパイルします。そのため、Java環境と使用している`javac`のバージョンが異なる場合、このエラーが発生します。 ターミナルで以下のコマンドを実行してJavaバージョンを確認できます： ```sh $ java -version ``` 同様に、ターミナルで以下のコマンドを実行して`javac`バージョンを確認できます： ```sh $ javac -version ``` その他のご質問がある場合は、[**support@zohocatalyst.com**](mailto:support@zohocatalyst.com)のCatalystサポートにお問い合わせください。 # リソースの初期化 ### catalyst initを使用してCatalystプロジェクトを初期化しようとすると'HTTP Error: 401. You do not have privileges to access this project. Please contact a project owner or an administrator of this account'エラーが発生するのはなぜですか？ この問題は、別のアカウントのCatalystプロジェクトがすでに含まれているフォルダで[プロジェクトを初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/introduction/)しようとした場合に発生します。また、別のアカウントから以前にプロジェクトが初期化された場所の新しいフォルダでプロジェクトを初期化しようとした場合にも発生します。 例：この場所でプロジェクトを初期化すると仮定します：*C/windows/system32/catalyst/aliencity* catalyst、system32、またはwindowsという名前のフォルダのルートにすでにCatalystプロジェクトが初期化されている場合、このエラーが発生します。ただし、これらのディレクトリ内の独自のフォルダにプロジェクトを配置することは可能です。 この問題を解決するには、現在のフォルダおよびパス内の他のフォルダから、`.catalystrc`という名前の隠しファイルを含むすべてのCatalyst関連ファイルを削除してから、`catalyst init`コマンドを再度実行してください。 # リソースのサーブ ### catalyst serveを実行すると'Cannot understand what targets. Check if you specified valid targets'エラーが発生するのはなぜですか？ `[catalyst serve](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/introduction/)`の実行中にこのエラーが発生した場合、以下の方法で解決できます： * ターゲットをサーブする際に正しいフォルダパスにいることを確認してください。 * プロジェクトディレクトリが空でなく、サーブ可能なリソースが少なくとも1つ含まれていることを確認してください。CatalystはBasic I/OおよびAdvanced I/Oタイプのファンクションエンドポイント、クライアント、AppSailリソースをサーブできます。また、`[catalyst pull](https://docs.catalyst.zoho.com/ja/cli/v1/pull-resources/introduction/)`コマンドを使用して、サーブする前にCatalystコンソールからローカルシステムにリソースの最新コードをプルすることもできます。 ### ローカルでno watchモードでファンクションをテストするにはどうすればよいですか？ Catalystはデフォルトでwatchモードでファンクションをサーブし、ホットコードリプレースメントを簡単に実行できるようにします。CLIコマンド`[catalyst serve --no-watch](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/functions-shell/#--no-watch)`を実行してno watchモードに切り替えることができます。 ### catalyst serveを使用したローカルデバッグ中にファイル関連の操作を行うと'Changes in file detected'や'Error: unable to proxy request'エラーメッセージが表示されるのはなぜですか？ このエラーは、`catalyst serve`コマンドでファイル操作を実行した際に発生します。この問題を解決するには、ファイル関連の操作を行うローカルデバッグ時に、catalyst serveで`[--no-watch](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/functions-shell/#--no-watch)`オプションを使用してください。`--no-watch`コマンドはホットモジュールリプレースメントを無効にします。 ### catalyst serveを使用してCatalystアプリケーションをローカルで実行しようとすると'Javac version is above the compatible version'エラーが発生するのはなぜですか？ Catalystは現在、Java 8、Java 11、Java 17、Java 21、Java 25のバージョンをサポートしています。そのため、CLIでJavaファンクションをデバッグする前に、インストールされている`java`と`javac`のバージョンが1.8.x、11.0.x、17.0.x、21.0.x、または25.0.xであることを確認する必要があります。 # CLI Functions Shell ### CLIを使用してCronファンクションをローカルでテストするにはどうすればよいですか？ CLIで[`catalyst shell`](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/functions-shell/)コマンドを使用して、[Cronファンクション](https://docs.catalyst.zoho.com/ja/serverless/help/functions/cron-functions/)をローカルで実行できます。JSON変数をCronファンクションへの入力として渡すことができます。Cronファンクションには、ローカルデバッグ中でもすべてのファンクション詳細を含む変数contextが含まれます。 ### CLIを使用してイベントファンクションをローカルでテストするにはどうすればよいですか？ Catalyst CLIで[`catalyst shell`](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/functions-shell/)コマンドを使用して、[イベントファンクション](https://docs.catalyst.zoho.com/ja/serverless/help/functions/event-functions/)をローカルで実行できます。catalyst event:generate {component} {action}コマンドを実行して、イベントファンクションのテスト用サンプルペイロードを生成できます。 例：`catalyst event:generate DataStore insert`。これにより、Data Storeの挿入操作用のサンプルペイロードが生成されます。生成されたペイロードをCLIでイベントファンクションへの入力として渡すことができます。 # リソースのデプロイ ### クライアントをデプロイしようとすると'We are unable to process the request since there are more than 500 files in the zip provided.'エラーが発生するのはなぜですか？ [クライアントフォルダ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/client-directory/)に500以上のファイルが存在する場合、このエラーが発生します。Catalyst Webクライアントで許可されるファイルの最大数は500です。