---
title: "Usar un proyecto de Catalyst"
url: https://docs.catalyst.zoho.com/es/cli/v1/working-with-projects/use-catalyst-project/
description: "Catalyst CLI te permite ver una lista de tus proyectos de Catalyst, asociar un proyecto con tu directorio de trabajo y restablecer el proyecto activo."
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
---

# Usar un proyecto de Catalyst

Usando Catalyst CLI, puedes asociar un proyecto de Catalyst para tu directorio de trabajo. Puedes agregar un proyecto de Catalyst existente y vincularlo con tu directorio.

Sin embargo, tu directorio solo puede estar vinculado y asociado permanentemente con su proyecto base, que es el proyecto que inicializaste en ese directorio. Por lo tanto, cuando uses otro proyecto en el directorio, la asociación con ese proyecto será solo temporal.

> **Nota:** Este comando solo se puede ejecutar desde un directorio de proyecto de Catalyst activo. Por lo tanto, si tu selección de directorio actual no es un directorio de proyecto activo, puedes [inicializar el proyecto](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/), o [traer sus componentes](https://docs.catalyst.zoho.com/es/cli/v1/pull-resources/introduction/) al directorio, en su lugar.

### Ejecución del comando

1. Para usar un proyecto de Catalyst en tu directorio de trabajo, ejecuta el siguiente comando desde el directorio requerido:

```sh
 catalyst project:use 
```

El CLI mostrará una lista de tus proyectos existentes de tu organización predeterminada.

2. Selecciona el proyecto que necesitas, usando las teclas de flecha. Presiona **Enter** para confirmar tu elección.

![Use Catalyst Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/working-with-projects/catalyst_cli_project_use.webp)

Tu proyecto ahora se agregará a tu directorio de trabajo y el CLI mostrará un mensaje de confirmación.

![Use Catalyst Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/working-with-projects/catalyst_cli_project_use_1.webp)

También puedes ejecutar el comando `catalyst project:use` con el nombre o el [Project ID](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) de ese proyecto para usarlo en el directorio de trabajo de la siguiente manera:

```sh
 catalyst project:use [name_or_project_id] 
```

![Use Catalyst Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/working-with-projects/catalyst_cli_project_use_2.webp)

> **Nota:** Si deseas usar un proyecto que pertenece a una organización que no es la predeterminada, asegúrate de incluir la opción `--org` y ejecutar el siguiente comando para usar el proyecto:

```sh
  catalyst project:use [name_or_project_id] --org<org_id> 
```

> **Nota:** Si eres usuario de **Visual Studio Code IDE**, puedes instalar la extensión **Catalyst Tools** y realizar la operación del CLI mencionada anteriormente usando tu IDE en lugar del CLI. Los pasos para agregar un proyecto de Catalyst a tu directorio de trabajo existente usando Visual Studio Code IDE se pueden encontrar [aquí](https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/catalyst-tools-explorer/)